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0.1 MANUAL OBJECTIVES AND READER ASSUMPTIONS 

This manual is intended to enable users to develop proqrams 
the MACRO-11 assembly language. 


coded in 


l° p]C1 ° r Knowledge of the MACRO-11 Relocatable Assembler is assumed, 
r 1 re f de n r should be familiar with the PDP-11 processors and 
related terminology, as presented in the PDP-11 Processor Handbooks, 
me reader is also encouraged to become familiar with the linkinq 
process, as presented in the applicable system manual (see Section 

0.3), because linking is necessary for the development of executable 
programs. 


a terminal is available to the reader, he/she is advised to try 
some o the examples in the manual or to write a few simple programs 
that illustrate the concepts covered. Even experienced programmers 
tind that working with a simple program helps them to understand a 
confusing feature of a new language. 


The 

may 

Part 


examples in this manual were done on an RT-1 
also be used on IAS/RSX-11M, RSX-11M-PLUS 
IV for information about operating procedure 


1 system. MACRO-11 
and RSTS systems (see 
s) . 


It can be assumed that all references to 
RSX-11M-PLUS with the exception of those 
with each system individually. 


RSX-11M also apply to 
in Chapter 8, which deals 


0.2 STRUCTURE OF THE DOCUMENT 

This manual has four parts and eight appendices. 

Part I introduces MACRO-11. 

Chapter 1 lists the key features of MACRO-11. 

Chapter 2 identifies the advantages of following programming 
standards and conventions and describes the format used in codinq 
MACRO-11 source programs. 

MAcnn I ^ 1 PreSen !;? g ? neral information essential to programming with the 
MACRO-11 assembly language. 

Chapter 3 lists the character set and describes the symbols, 
erms, and expressions that form the elements of MACRO-11 
instructions. 
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Chapter 4 describes the output of MACRO-11 and presents concepts 
essential to the proper relocation and linking of object modules. 


Chapter 5 describes how data stored in memory can be accessed and 
manipulated using the addressing modes recognized by the PDP-11 
hardware. 

Part III describes the MACRO-11 directives that control the processing 
of source statements during assembly. 

Chapter 6 discusses directives used for generalized MACRO-11 
functions. 

Chapter 7 discusses directives used in the definition and 
expansion of macros. 

Part IV presents the operating procedures for assembling MACRO-11 
programs. 

Chapter 8 covers the IAS, RSX-11M, and RSX-11M-PLUS systems. 
Chapter 9 covers the RSTS/RT-11 systems. 

Appendix A lists the ASCII and Radix-50 character sets used in 
MACRO-11 programs. 

Appendix B lists the special characters recognized by MACRO-11, 
summarizes the syntax of the various addressing modes used in PDP-11 
processors, and briefly describes the MACRO-11 directives m 
alphabetical order. 

Appendix C lists alphabetically the permanent symbols that have been 
defined for use with MACRO-11. 

Appendix D lists alphabetically the error codes produced by MACRO-11 
to identify various types of errors detected during the assembly 
process. 

Appendix E contains a coding standard that is recommended practice in 
preparing MACRO-11 programs. 

Appendix F discusses several methods of conserving dynamic memory 
space for users of small systems who may experience difficulty in 
assembling MACRO-11 programs. 

Appendix G is a discussion of position-independent code (PIC). 

Appendix H contains an assembly and cross-reference listing. 

Appendix I contains obsolete MACRO-11 directives, syntax, and command 
line options. 

Appendix J describes the differences from the last release of 
MACRO-11. 
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0.3 ASSOCIATED DOCUMENTS 

For descriptions of documents associated with this manual, refer to 
the applicable documentation directory listed below: 

IAS Documentation Directory 

RSX-11M-PLUS Information Directory and Index 
RSX-11M/RSX-1IS Information Directory and Index 
Guide to RT-11 Documentation 
RSTS/E Documentation Directory 




0.4 DOCUMENT CONVENTIONS 

The color red is used in command string examples to indicate user 
type-in. 

The symbols defined below are used throughout this manual. 


Symbol 


Definition 


[] 


UPPER-CASE 

CHARACTERS 

lower-case 

characters 


Brackets indicate that the enclosed argument is 
optional. 

Ellipsis indicates optional continuation of an argument 
list in the form of the last specified argument. 

Upper-case characters indicate elements of the language 
that must be used exactly as shown. 

Lower-case characters indicate elements of the language 
that are supplied by the programmer. 


(n) 


In some instances the symbol (n) is used following a 
number to indicate the radix. For example, 100(8) 
indicates that 100 is an octal value, while 100(10) 
indicates a decimal value. 
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CHAPTER 1 


THE MACRO-11 ASSEMBLER 


MACRO-11 provides the following features: 

1. Source and command string control of assembly functions 

2. Device and filename specifications for input and output files 

3. Error listing on command output device 

4. Alphabetized, formatted symbol table listing; optional 
• cross-reference listing of symbols 

5. Relocatable object modules 

6. Global symbols for linking object modules 

7. Conditional assembly directives 

8. Program sectioning directives 

9. User-defined macros and macro libraries 

10. Comprehensive system macro library 

11. Extensive source and command string control of listinq 
functions. 

MACRO-11 assembles one or more ASCII source files containing MACRO-11 
statements into a single relocatable binary object file. The output 
of MACRO-11 consists of a binary object file and a file containing the 
table of contents, the assembly listing, and the symbol table. An 
optional cross-reference listing of symbols and macros is available. 
A sample assembly listing is provided in Appendix H. 


1.1 ASSEMBLY PASS 1 

During pass 1, MACRO-11 locates and reads all required macros from 
libraries, builds symbol tables and program section tables for the 
program, and performs a rudimentary assembly of each source statement. 

In the first step of assembly pass 1, MACRO-11 initializes all the 
impure data areas (areas containing both code and data) that will be 
used internally for the assembly process. These areas include all 
dynamic storage and buffer areas used as file storage regions 
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THE MACRO-11 ASSEMBLER 


MACRO-11 then calls a system subroutine which transfers a command line 
into memory. This command line contains the specifications of all 
files to be used during assembly. After scanning the command line for 
proper syntax, MACRO-11 initializes the specified output files. These 
files are opened to determine if valid output file specifications have 
been passed in the command line. 

MACRO-11 now initiates a routine which retrieves source lines from the 
input file. If no input file is open, as is the case at the beginning 
of assembly, MACRO-11 opens the next input file specified in the 
command line and starts assembling the source statements. MACRO-11 
first determines the length of the instructions, then assembles them 
according to length as one word, two words, or three words. 

At the end of assembly pass 1, MACRO-11 reopens the output files 
described above. Such information as the object module name, the 
program version number, and the global symbol directory (GSD) for each 
program section are output to the object file to be used later in 
linking the object modules. After writing out the GSD for a given 
program section, MACRO-11 scans through the symbol tables to find all 
the global symbols that are bound to that particular program section. 
MACRO-11 then writes out GSD records to the object file for these 
symbols. This process is done for each program section. 


1.2 ASSEMBLY PASS 2 

On pass 2 MACRO-11 writes the object records to the output file while 
generating both the assembly listing and the symbol table listing for 
the program. A cross-reference listing may also be generated. 

Basically, assembly pass 2 consists of the same steps performed in 
assembly pass 1, except that all source statements containing 
MACRO-11-detected errors are flagged with an error code as the 
assembly listing file is created. The object file that is created as 
the final consequence of pass 2 contains all the object records, 
together with relocation records that hold the information necessary 
for linking the object file. 

The information in the object file, when passed to the Task Builder or 
Linker, enables the global symbols in the object modules to be 
associated with absolute or virtual memory addresses, thereby forming 
an executable body of code. 

The user may wish to become familiar with the macro object file format 
and description. This information is presented in the applicable 
system manual (see Section 0.3 in the Preface). 
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CHAPTER 2 


SOURCE PROGRAM FORMAT 


2.1 PROGRAMMING STANDARDS AND CONVENTIONS 

Programming standards and conventions allow code written by a person 
(or group) to be easily understood by other people. These standards 
also make the program easier to: 

Plan 

Comprehend 
Test 
Modify 
Convert 


The actual standard used must meet local 
coding standard is provided in Append 
users, this coding example simplifies 
continuing task of software maintenance 


user requirements. A sample 
ix E. Used by DIGITAL and its 
both communications and the 
and improvement. 


2.2 STATEMENT FORMAT 

A source program is composed of assembly-language statements. Each 
statement must be completed on one line. Although a line may contain 
132 characters (a longer line causes an error (L) in the assembly 
listing), a line of 80 characters is recommended because of 
constraints imposed by listing format and terminal line size. Blank 
lines, although legal, have no significance in the source program. 

A MACRO-11 statement may have as many as four fields. These fields 
are identified by their order within the statement and/or by the 
separating characters between the fields. The general format of a 
MACRO-11 statement is: 

[Label:] Operator Operand [;Comment(s)] 

The label and comment fields are optional. The operator and operand 
fields are interdependent; in other words, when both fields are 
present in a source statement, each field is evaluated by MACRO-11 in 
the context of the other. 


A statement may 
not true. A 
illegal and is i 
.WORD directive 


contain an operator and no operand, but the reverse is 
statement containing an operand with no operator is 
nterpreted by MACRO-11 during assembly as an implicit 
( see Section . 3.2) . 


MACRO-11 interprets and processes source program statements one by 
one. Each statement causes MACRO-11 either to perform a specified 
assembly process or to generate one or more binary instructions or 
data words. 


2-1 





SOURCE PROGRAM FORMAT 


2.2.1 Label Field 

A label is a user-defined symbol which is assigned the value of the 
current location counter and entered into the user—defined symbol 
table. The current location counter is used by MACRO-11 to assign 
memory addresses to the source program statements as they are 
encountered during the assembly process. Thus, a label is a means of 
symbolically referring to a specific statement. 

When a program section is absolute, the value of the current location 
counter is absolute; its value references an absolute virtual.memory 
address (such as location 100). Similarly, when a program section is 
relocatable, the value of the current location counter is relocatable; 
a relocation bias calculated at link time is added to the apparent 
value of the current location counter to establish its effective 
absolute virtual address at execution time. (For a discussion of 
program sections and their attributes, see Section 6.7.) 

If present, a label must be the first field in a source statement and 
must be terminated by a colon (:). For example, if the value of the 
current location counter is absolute 100(8) , the statement: 

ABCD: MOV A,B 

assigns the value 100(8) to the label ABCD. If the location counter 
value were relocatable, the final value of ABCD would be 100(8)+K, 
where K represents the relocation bias of the program section, as 
calculated by the Task Builder or Linker at link time. 

More than one label may appear within a single label field. Each 
label so specified is assigned the same address value. For example, 
if the value of the current location counter is 100(8), the multiple 
labels in the following statement are each assigned the value 100(8): 

ABC: $DD: A7.7: MOV A,B 

Multiple labels may also appear on successive lines. For example, the 
statements 

ABC: 

$DD: 

A7.7: MOV A,B 

likewise cause the same value to be assigned to all three labels. 
This second method of assigning multiple labels is preferred because 
positioning the fields consistently within the source program makes 
the program easier to read (see Section 2.3). 

A double colon (::) defines the label as a global symbol. For 
example, the statement 

ABCD:: MOV A,B 

establishes the label ABCD as a global symbol. The distinguishing 
attribute of a global symbol is that it can be referenced from within 
an object module other than the module in which the symbol is defined 
(see Section 6.8) or by independently assembled object modules. 
References to this label in other modules are resolved when the 
modules are linked as a composite executable image. 
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The legal characters for defining labels are: 

A through z 
0 through 9 
. (Period) 

$ (Dollar Sign) 


NOTE 

By convention, the dollar sign ($) and 
period (.) are reserved for use in 
defining DIGITAL system software 
symbols. Therefore these characters 
should not be used in defining labels in 
MACRO-11 source programs. 


A label may be any length; however, only the first six characters are 
significant and, therefore, must be unique among all the labels in the 
source program. An error code (M) is generated in the assembly 

listing if the first six characters in two or more labels are the 
same. 

A symbol used as a label must not be redefined within the source 
program. If the symbol is redefined, a label with a multiple 
definition results, causing MACRO-11 to generate an error code (M) in 
the assembly listing. Furthermore, any statement in the source 
program which references a multi-defined label generates an error code 
(D) in the assembly listing. 


2.2.2 Operator Field 

The operator field specifies the action to be performed. It may 
consist of an instruction mnemonic (op code), an assembler directive, 
or a macro call. Chapters 6 and 7 describe these three types of 
operators. 


When the operator is an instruction mnemonic, a machine instruction is 
generated and MACRO-11 evaluates the addresses of the operands which 
follow. When the operator is a directive MACRO-11 performs certain 
control actions or processing operations during the assembly of the 
source program. When the operator is a macro call, MACRO-11 inserts 
the code generated by the macro expansion. 

Leading and trailing spaces or tabs in the operator field have no 
significance; such characters serve only to separate the operator 
field from the preceding and following fields. 


An operator is terminated by a space, tab, or any 
character*, as in the following examples: 


non-RAD50 


MOV A,B 

;The 

MOV A, 

B ;The 

mov@a,b 

; The 

* Appendix A.2 

contains 


I 
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Although the statements above are all equivalent in function, the 
second statement is the recommended form because it conforms to 
MACRO-11 coding conventions. 


2.2.3 Operand Field 

When the operator is an instruction mnemonic (op code) , the operand 
field contains program variables that are to be evaluated/manipulated 
by the operator. The operand field may also supply arguments to 
MACRO-11 directives and macro calls, as described in Chapters 6 and , 
respectively. 

Operands may be expressions or symbols, depending on the operator. 
Multiple expressions used in the operand field of a MACRO-11 statement 
must be separated by a comma; multiple symbols similarly used may be 
delimited by any legal separator (a comma, tab, and/or space). An 
operand should be preceded by an operator field; if it is not, the 
statement is treated by MACRO-11 as an implicit .WORD directive (see 
Section 6.3.2) . 

When the operator field contains an op code, associated operands are 
always expressions, as shown in the following statement: 

MOV R0,A+2(R1) 

On the other hand, when the operator field contains a MACRO-11 
directive or a macro call, associated operands are normally symbols, 
as shown in the following statement: 

.MACRO ALPHA SYM1,SYM2 

Refer to the description of each MACRO-11 directive (Chapter 7) to 
determine the type and number of operands required in issuing the 
directive. 

The operand field is terminated by a semicolon when the field is 
followed by a comment. For example, in the following statement: 

LABEL: MOV A,B ;Comment field 

the tab between MOV and A terminates the operator field and defines 
the beginning of the operand field; a comma separates the operands A 
and B; and a semicolon terminates the operand field and defines the 
beginning of the comment field. When no comment field follows, the 
operand field is terminated by the end of the source line. 


2.2.4 Comment Field 

The comment field normally begins in column 33 and extends through the 
end of the line. This field is optional and may contain any ASCII 
characters except null, RUBOUT, carriage-return, line-feed, 
vertical-tab or form-feed. All other characters appearing in the 
comment field, even special characters reserved for use in MACRO-11, 
are checked only for ASCII legality and then included in the assembly 
listing as they appear in the source text. 
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All comment fields must begin with a semicolon (;). when lenothv 
s ex £ e "d beyond the end of the source line (column 80)? the 
omment may be resumed in a following line. Such a line must contain 
leading semicolon, and it is suggested that the body of the comment 
be continued in the same columnar position in which the comment began 

insrs: coar b .aT also be S ep, r M; 


Comments do not affect assembly processing or 
However, comments are necessary in source listings 
debugging, or documentation purposes. 


program execution, 
for later analysis. 


2.3 FORMAT CONTROL 

Korizionta 1 formatting of the source program is controlled by the space 
and tab characters. These characters have no effect on the assembly 
process unless they are embedded within a symbol, number, or ASCII 
s );£ ln< 3' or unless they are used as the operator field terminator. 
Thus, the space and tab characters can be used to provide an orderly 
and readable source program. 1 

DIGITAL's standard source line format is shown below: 

Label - begins in column 1 

Operator - begins in column 9 

Operands - begin in column 17 

Comments - begin in column 33. 

These formatting conventions are not mandatory; free-field coding is 
permissible. However, note the increase readability after formattinq 
in the example below: 

REGTST:BIT#MASK,VALUE;COMPARES BITS IN OPERANDS. 

1 ^ 17 33 (columns) 

REGTST: BIT #MASK,VALUE ;Compares bits in operands. 

Page formatting and assembly listing considerations are discussed in 
Chapter 6 in the context of MACRO-11 directives that may be specified 
to accomplish desired formatting operations. Appendix E contains a 
sample coding standard. 


» 
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CHAPTER 3 

SYMBOLS AND EXPRESSIONS 


This chapter describes the components of 
character set, the conventions observed 
the use of numbers, operators, terms and 


MACRO-11 instructions: 

in constructing symbols, 
expressions. 


the 

and 


3.1 CHARACTER SET 


The following characters are legal in MACRO-11 source programs 


1 . 


2 . 


The letters A through Z. Both upper- 
are acceptable, although, upon input, 
converted to upper-case (see Section 6 


and lower-case letters 
lower-case letters are 
.2.1, .ENABL LC). 


The digits 0 through 9. 


3. 


The characters . (period) and $ 
characters are reserved for use 
Corporation system program symbols. 


(dollar sign). These 
as Digital Equipment 


4. The special characters listed in Table 3-1. 


Table 3-1 

Special Characters Used in MACRO-11 


Character 

Designation 

Function 

: 

Colon 

Label terminator. 

• * 

Double colon 

Label terminator; defines the 
label as a global label. 


Equal sign 

Direct assignment operator and 
macro keyword indicator. 


Double equal 
sign 

Direct assignment operator; 
defines the symbol as a global 
symbol. 


Equal sign colon 

Direct assignment operator; 
macro keyword indicator; 
causes error (M) in listing if 
an attempt is made to change 
the value of the symbol. 


(continued on next page) 
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Table 3-1 (Cont.) 

Special Characters Used in MACRO-11 


Designation 


Function 


Double equal 
sign colon 

Direct assignment operator; 
defines the symbol as a global 
symbol; causes error (M) in 
listing if an attempt is made 
to change the value of the 
symbol. 

Percent sign 

Register term indicator. 

Tab 

Item or field terminator. 

Space 

Item or field terminator. 

Number sign 

Immediate expression 
indicator. 

At sign 

Deferred addressing indicator. 

Left parenthesis 

Initial register indicator. 

Right parenthesis 

Terminal register indicator. 

Period 

Current location counter. 

Comma 

Operand field separator. 

Semicolon 

Comment field indicator. 

Left angle 
bracket 

Initial argument or expression 
indicator. 

Right angle 
bracket 

Terminal argument or 
expression indicator. 

Plus sign 

Arithmetic addition operator 
or autoincrement indicator. 

Minus sign 

Arithmetic subtraction 
operator or autodecrement 
indicator. 

Asterisk 

Arithmetic multiplication 
operator. 

Slash 

Arithmetic division operator. 

Ampersand 

Logical AND operator. 

Exclamation point 

Logical inclusive OR operator. 

Double quote 

Double ASCII character 
indicator. 


(continued on next page) 
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Table 3-1 (Cont.) 

Special Characters Used in MACRO-11 


Character 

Designation 

Function 

i 

Single quote 

Single ASCII character 
indicator; or concatenation 
indicator. 


Up arrow or 
c i rcumflex 

Universal unary operator or 
argument indicator. 

\ 

Backslash 

Macro call numeric argument 
indicator. 


3.1.1 Separating and Delimiting Characters 


Legal separating characters and legal 
in Tables 3-2 and 3—3 respectively. 


argument delimiters are 


defined 




Table 3-2 

Legal Separating Characters 


Character 

Definition 

Usage 

Space 

One or more spaces 
and/or tabs 

A space is a legal separator 
between instruction fields and 
between symbolic arguments 
within the operand field. 
Spaces within expressions are 
ignored (see Section 3.9). 

r 

Comma 

A comma is a legal separator 
between symbolic arguments 
within the operand field. 
Multiple expressions used in 
the operand field must be 
separated by a comma. 


3.1.2 Illegal Characters 

A character is illegal for one of two reasons* 

t£ 15^ i’ t S.-SS- u“." hlch ' 

printed m the assembly listing. ^ ls 


l 
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Table 3-3 

Legal Argument Delimiters 


Character Definition 


< # ## > Paired angle 

brackets 


Up-arrow (unary 
operator) con¬ 
struction, where 
the up-arrow is 
followed by an 
argument that is 
bracketed by any 
paired printing 
characters (x). 


Usage 


Paired angle brackets may be 

used anywhere in a program to 
enclose an expression for 
treatment as a single term. 
Paired angle brackets are also 
used to enclose a macro 
argument, particularly when 
that argument contains 
separating characters (see 
Section 7.3). 

This construction is 
equivalent in function to the 
paired angle brackets 
described above and is 
generally used only where the 
argument itself contains angle 
brackets. 


3.1.3 Unary and Binary Operators 


Legal MACRO-11 unary operators are described in Tabl 
operators are used in connection with single terms 
operands) to indicate an action to be performed on that 
assembly. Because a term preceded by a unary operator 
to contain that operator, a term so specified can be used 
an element of an expression. 


3-4. Unary 
(arguments or 
term during 
is considered 
alone or as 


Table 3-4 

Legal Unary Operators 


Unary 

Operator 

Explanation 

Example 

Effect 

+ 

Plus sign 

+A 

Produces the positive 
value of A. 

- 

Minus sign 

-A 

Produces the negative 
(2's complement) 




value of A. 

-------(continued on next page; 
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Table 3-4 (Cont.) 
Legal Unary Operators 


Unary 

Operator Explanation 


Example 


Effect 


Up-arrow, universal 

~C24 

Produces the l's 

unary operator. 

(This usage is 
described in 


complement value of 
24(8). 

detail in 

Section 6.4.) 

~D127 

Interprets 127 as a 
decimal number. 


~F3.0 

Interprets 3.0 as a 
1 -word, 

floating-point 

number. 


~034 

Interprets 34 as an 
octal number. 


~B110001H 

Interprets 11000111 

as a binary number. 


~RABC 

Evaluates ABC in 

Radix-50 form. 





Unary operators can be used adjacent to each other or 
involving multiple terms, as shown below: 


in constructions 


-~D50 (Equivalent to -<~D50>) 
/ 'C /N 012 (Equivalent to ~C<~012>) 


Legal MACRO-11 binary 
contrast to unary 
performed on multiple 


operators are described in Table 3-5 
operators, binary operators specify actions 
items or terms within an expression. 


to 


In 

be 


Table 3-5 

Legal Binary Operators 


Binary 

Operator Explanation Example 


+ 

Addition 

A+B 


- 

Subtraction 

A-B 


* 

Multiplication 

A*B 

(signed 16-bit 
product returned) 

/ 

Division 

A/B 

(signed 16-bit 
quotient returned) 

& 

Logical AND 

A&B 


I 

Logical inclusive OR 

A! B 



I 


3-5 
















SYMBOLS AND EXPRESSIONS 


I 


All binary operators have equal 
brackets are evaluated first, 
from left to right, as shown in 


priority. Terms enclosed 
and remaining operations are 
the examples below: 


by angle 
performed 


.WORD 1+2*3 
.WORD l+<2*3> 


;Equals 11(8). 
;Equals 7(8) . 



3.2 MACRO-11 SYMBOLS 

MACRO-11 maintains a symbol table for each of the three rm gnent 
that mav be defined in a MACRO-11 source program: the Permanent 
qJmbol Table (PST), the User Symbol Table (UST), and the Macro Symbol 
TbTe TJsi) toe PST contains all the permanent symbols defined 
litiin (and thus automatically recognized by) MACRO-11 and is part of 
the MACRO-11 image. The UST (for user-defined symbols) and MST (for 
macro symbols) are 9 constructed as the source program is assembled. 


3.2.1 Permanent Symbols 

Permanent symbols consist of the instruction mnemonics (see Appendix 
C) and MACRO-11 directives (see Chapters 6 and 7 and Appendix B). 
These symbols are a permanent part of the MACRO-11 image and nee no 
be defined before being used in the operator field of a MACRO-11 
source statement (see Section 2.2.2). 



3.2.2 User-Defined and Macro Symbols 


User-defined symbols are those symbols that are equated to a specific 
value through a direct assignment statement (see Section 3.3) , appear 
as ?abe5s (see Section 2.2.1), or act as dummy arguments (see Section 
7.1.1). These symbols are added to the User Symbol Table as they are 
encountered during assembly. 


Macro 

They 

during 


symbols are those symbols used as macro names (see Section 7.1). 
are added to the Macro Symbol Table as they are encountered 
assembly. 


The following rules govern the creation of user-defined and macro 
symbols: 

1. Symbols can be composed of alphanumeric characters, dollar 
signs ($) f and periods (.) only (see Note below). 

2. The first character of a symbol must not be a number (except 
in the case of local symbols; see Section 3.5)• 


3. 


4 . 


The first six characters of a symbol must be unique. A 
symbol can be written with more than six legal characters, 
but the seventh and subsequent characters are checked only 
for ASCII legality and are not otherwise evaluated or 
recognized by MACRO-11. 

Spaces, tabs, and illegal characters must not be embedded 
within a symbol. The legal MACRO-11 character set is defined 
in Section 3.1. 





I 
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The dol 
cha racte 
defining 
system 
READ$ is 
The use 
these 
user-def 
order to 
existing 
Corporat 


NOTE 

lar sign ($) and period (.) 
rs are reserved for use in 
Digital Equipment Corporation 
software symbols. For example, 
a file-processing system macro, 
r is cautioned not to employ 
characters in constructing 
ined symbols or macro symbols in 
avoid possible conflicts with 
. or future Digital Equipment 
ion system software symbols. 


Tn B the^opfrator^lefd^ 3 T° itS USe in the Program. A symbol 
describe, Lov^r p.'’^d^mJne^ 

In^heiono^nroTe?! 61 " Symb01 ' MACR °- 11 Searches the s ^ bo1 ^ 

1. Macro Symbol Table 

2. Permanent Symbol Table 

3. User-Defined Symbol Table 

^mbols arCh Bur e th p all ° WS Pe ™ a " ent symbols to be used as macro 
\ B fc u h f r must kee P ln mind the sequence in which the 
search for symbols is performed in order to avoid incorrect 
interpretation of the symbol's use. correct 

When a symbol appears in the operand field, the search order is: 

1. User-Defined Symbol Table 

2. Permanent Symbol Table 

have nd ei?her • tbe S ° urce P ro 9 ram ' user-defined symbols 

attributed local < lnternal ) attribute or a global (external) 

— R ? -11 breats a11 user-defined symbols as local, that is 
their definition is limited to the module in which they appear' 

However, symbols can be explicitly declared to be global symbols 
through one of three methods: 9 a± symDols 


1 . 

2 . 


Use of the .GLOBL directive (see Section 6.8.1). 

Use of the double colon (::) in defining a label (see Section 

3 * ^? ubl f equ? 1 sign ( = =) or double equal colon sign 

l •) n a direct assignment statement (see Section 3.3). 

Ali symbols within a module that remain undefined at the end of 
assembly are treated as default global references. 


I 
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NOTE 

Undefined symbols at the end of assembly 
are assigned a value of 0 and placed 
into the user-defined symbol table as 
undefined default global references. If 
the .DSABL GBL directive is in effect, 
however, (see Section 6.2.1) the 
statement containing the undefined 
symbol is flagged with an error code (U) 
in the assembly listing. 


Global symbols provide linkages between independently-assembled object 
modules within the task image. A global symbol defined as a label, 
for example may serve as an entry-point address to another section o 
code wi?hin the image. Such symbols are referenced from other source 
modules in order to transfer control throughout esu J t J®g 

global symbols are resolved at link time, ensuring that the resulting 
image is a logically coherent and complete body of code. 


3.3 DIRECT ASSIGNMENT STATEMENTS 

The general format for a direct assignment statement is: 
symbol=express ion 
or 


symbol==expression 

can have only one level of forward reference 
(see 5. below). 

cannot contain an undefined global reference. 
The colon format for a direct assignment statement is: 
symbol=:expression 


where: expression - 


or 


symbol== expression 
where: expression 


can have only one level of forward reference 
(see 5. below). 

cannot contain an undefined global reference. 


All the direct assignment statements above allow the user to equate a 
symbol with a specific value. After the symbol has been defined it is 
entered into the User-Defined Symbol Table. If the general format is 
used (= or ==) the value of the symbol may be changed in subsequent 
direct assignment statements. If, however, the colon format IS used 
(=: or ==:) any attempt to change the value of the symbol will 

generate an error (M) in the assembly listing. 


A direct assignment statement embodying either the double 
sign or the double equal colon (==:) sign, as shown above 
symbol as global (see Section 6.8.1) • 


equal (==) 
defines the 
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EXPRESSIONS 


The following examples illustrate 
statements. 


the coding 


of direct assignment 


Example 1 : 


A=10 

;Direct assignment 

B==30 

;Global assignment 

A=15 

;Legal reassignment 

L=: 5 

;Equal colon assignment 

M==:A+2 

; D°uble equal colon assignment 
;M becomes equal to 17 

H 

/Illegal reassignment 
;M error is generated 

Example 2: 



C: 
D=. 
E: 


MOV #1, ABLE 


;The symbol 
;the labels 
;value that 
;of the MOV 


D is equated to ., and 
C and E are assigned a 
is equal to the location 
instruction. 


The code in the second exampl 
shown only to illustrate 
situations. See Section 3.6 
the current location counter 


e above would not 
the performance 
for a description 
symbol. 


usually be used and is 
of MACRO-11 in such 
of the period (.) as 


The following conventions apply to the codi 
statements: 


ng of direct assignment 


1 . 


3. 


An equal sign (-), double equal sign ( = =) , equal colon siqn 

Spaces preceding and/or following the direct assionment 
?e P s e ;?K„ r g%a a ;^ U9h »-e no slgn^.n^iT ?h"e 

placer^ 1 tEe^berfield. 1 " “ d ‘ raCt assI 9™ e "' statement is 
statement?^ mb °^ "" ^ d ' £1 " ad ln 3 si "^ ««ct assignment 
comment t field? nment -S' followed only by a 


Only one level of forward referencing is allowed The 
following example would cause an error code 
assembly listing on the line containing the 
reference: 


(U) in the 
illegal forward 


(Illegal forward reference) 
(Legal forward reference) 
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Although one level of forward referencing g^^gy^ois^ln 

symbols, no forward r ® f ® r ?p i a g ass i qne d to a global symbol can 
other words, the expression be g g g bols< A forward reference in a 

contain only previously d ^ alobal symbol will cause an 

direct assignment statement defining a global symDoi 

W to be generated in the assembly listing. 


3.4 REGISTER SYMBOLS 


manner: 


%0 

%1 


%7 


where % indicates a reference to a register tjth« than a lotion 
absolute* term'’that^ can b^va^e^ur^ £ fCft’assemLy U». 


program. 


R0=%0 
R .1 = % 1 
R2 = %2 
R3 = %3 
R4 = %4 
R5 = %5 
S P=%6 
PC = %7 


^Register 0 definition. 
; Register 1 definition. 


definition, 
definition, 
definition. 

_ definition. 

Stack pointer definition. 
Program counter definition. 


•Register 
;Register 
;Register 
;Register 


Registers 6 and 7 are given special names because of .their unique 
system functions^ The symb,lie in all 

DlI^lippHed 5 PDP-Usystem programs. For this reason, you are 
advised to follow these conventions. 


register symbol may .%T.UJ 

appearing in ^ ; Jh between 0 and 7, inclusive, or 

irfrrSrcod.^r^^appe.r in the assembly listing. Although you 
can reassign the standard regl ®p®^ i ^ m 621) this practice is not 

“Ste^^nfon «us T at Unment statement to ^e^flagged 

register bi^ef SSedVfor: thZy are ’referenced in the 

source program. 
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The % character may be used with 
specify a register. For example. 


any legal term 
the statement 


or 


expression 


to 


CLR %3+l 


is equivalent in function to the statement 
CLR %4 

and clears the contents of register 4. 

In contrast, the statement 
CLR 4 


clears the contents of virtual memory location 4. 


3.5 LOCAL SYMBOLS 

symbols are specially formatted symbols used as labels within a 

r Lirrv- - - 

to 65535, inclusive. Examples of local symbols are: 

1 $ 

27$ 

59$ 

104$ 

A local symbol block is delimited in one of three ways: 

lm ° f u a local s y mbo1 block usually consists of 

tatements between two normally-constructed symbolic 
(see Figure 3-1). Note that a statement of the form! 

ALPHA=EXPRESSION 


those 

labels 


3. 


IS a direct assignment statement (see Section 3.3) but does 

his : 1 and thus d °» -•* •?“ 

The range of a local symbol block is normally terminated upon 
encountenng a .PSECT, .CSECT, .ASECT, or .RESTORE directive 
in the source program (see Figure 3-1). 

MACRO-l^di recti vestas ^ dell " ited through 

Starting delimiter: .ENABL LSB (see Section 6.2.1) 
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Ending delimiter: .ENABL LSB 

or 

one of the following: 


Symbolic label (see Section 2.2.1) 
.PSECT (see Section 6.7.1) 

.CSECT (see Section 6.7.2) 

.ASECT (see Section 6.7.2) 
.RESTORE (see Section 6.7.4) 


encountered after a .DSABL LSB (see 
Section 6.2.1). 


s for 
symbol 
with 
ition, 
local 
their 
name 
Local 
less 
use is 


Local symbols provide a convenient means of generating label 
branch instructions and other such references within local 
blocks Using local symbols reduces the possibility of symbols 
!i e definitions Appearing within a user Program In add 
the use of local symbols differentiates entry-point labels from 
labels 6 since local symbols cannot be referenced from outside 
respective local symbol blocks. Thus, local symbols of the same 
can appear in other local symbol blocks without conflict, 
symbols do not appear in cross-reference listings and require 
symbol table space than other types of symbols. Their 

recommended. 

When defining local symbols, use the range from 1$ to ^999$ first. 

Local symbols within the range 30000$ thro ^ h M ^”5$, lnc ^“ ve { 0 °*; 
be generated automatically as a feature of MACRO-11. Such local 
symbols are useful in the expansion of macros during assembly (see 

Section 7.3.5)• 

Be sure to avoid multiple definitions of local symbols within the same 
local symbol block. For example, if the local symbol 10$ is defined 
two or more times within the same local symbol block each symbol 
represents a different address value. Such a multi defined sym 
causes an error code (P) to be generated in the assembly listing. 

For examples of local symbols and local symbol blocks as they appear 
in a source program, see Figure 3-1. 


1 »+ 

2 f Simple i1lustration of local 

3 i by the label XCTPAS* 

4 »“ 


5 

6 

000000 

0.12700 

XCTPR6« 

MOV 

♦IMPURE'RO 

7 

000004 

0000006 

005020 

if: 

CLR 

(R0) + 

8 

000006 

020027 


CMP 

R0 'tlMPURT 

9 

000012 

0000006 

001374 


BNE 

If 

10 

11 

12 

000014 

012700 

XCTPASJ 

MOV 

♦IMPPASfR0 

13 

000020 

0000006 

005020 

if: 

CLR 

(R0) + 

14 

000022 

020027 


CMP 

R0 »flMPPAT 

15 

000026 

0000006 

001374 


BNE 

If 

16 

000030 

000207 


RTS 

PC 


symbolst the second block is delimited 


}Point to impure area 

iClear a word 
* Test if at top of area 

'Iterate if not 

»Fall in to perform pass initialization 

»Point to pass storage area 

JClear the area 
»Test if at top of area 

'Iterate of not 
'Return if so 


Figure 3-1 Assembly Listing Showing Local Symbol Block 


«P 


•k 

I 

I 
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3.6 CURRENT LOCATION COUNTER 


The period (.) i S the symbol for the currenr i rec¬ 
used in the operand field of an instruct-inn catl °n cou nter. When 
address of the 'first word of t£e inst-cM™ P ! ri ° d re ? res *" ts the 
example below. when used in ^ruction as shown in the first 

directive, it represents the a H rp °?* rand field of a MACRO-11 
shown in the second example below. ° 6 current b y te or word, as 


MOV 


#. ,R0 


I™ 6 P er *°? <•> refers to the address 
,of the MOV instruction. 


.WORD 


(The function of the number sign (#) is explained in Section 5.9.) 
SAL=0 

177535,.+4,SAL ;The operand .+4 in the .WORD 
.•directive represents a value 
; that is stored as the second 
;°f three words during 
/assembly. 


Assume that the current value of the 
assembly, MACRO-11 reserves storaqe 
(see Section 6.3.2), beginning wi 
accompanying the .WORD directive de 
value 177535 is thus stored in locat 
.+4 is stored in location 502; th 
value of the location counter (which 
value 4, thereby depositing the va 
the value of SAL, previously equated 
504. 


location counter is 500 
in response to the .WORD 
th location 500. The 
termine the values so sto 
ion 500. The value repre 
is value is derived as th 
is now 502), plus the 
lue 506 in location 502. 
to 0, is deposited in 


During 
directive 
operands 
red. The 
sented by 
e current 
absolute 
Finally, 
loca tion 


Figure 3-2 illustrates the result of the example. 


LOCATION 

500 

502 

504 


CONTENTS 

177535 

506 

0 


Figure 3-2 Sample Assembly Results 

co™^r be9 -‘No^n!; " Ch asse ” bl >’ MACRO-11 resets the location 

byte of object S;Vf*^'V° 

TolltlWToJ* ° han9ed thr ° U9h ’ assig„ment°stateme„t°of t the 


•=expression 

The current 
relocatable , 
section. 


location counter symbol (.) i s either absolute 
depending on the attribute of the current progr 


or 
program 


I 
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The attribute of the current location counter can ^| ECT .cSECT and 

through the program sectioning directives (.PSECT, ; ^ECT ^ ^ 

.RESTORE), as described in Section 6.7. Therefore, g y the 

counter an expression having an attribute different tnan 

current program section will generate an error code IA) 
assembly listing. 

P Utth . r re an expression ^toCsly 

HBH°se%H!ill^ »'«rS 

code (P) in the assembly listing. 


The following coding illustrates 
counter: 


the 


use 


of the current location 


.ASECT 

.=500 

FIRST: MOV .+10,COUNT 


.=520 


SECOND: MOV .,INDEX 


.PSECT 


.=.+20 


THIRD: .WORD 0 


Set location counter to 
absolute 500(octal). 

The label "FIRST" has the value 
500(octal). 

.+10 equals 510 (octal). The 
contents of the location 
510(octal) will be deposited 
in the location "COUNT". 

The assembly location counter 
now has a value of 
absolute 520(octal). 

The label "SECOND" has the 
value 520(octal). 

The contents of location 
520(octal), that is, the binary 
code for the instruction 
itself, will be deposited in the 
location "INDEX". 

;Set location counter to 
;relocatable 20 of the 
;unnamed program section. 

; The label "THIRD" has the 
;value of relocatable 20. 


Storage areas may be reserved in the program by advancing the location 
counter, “r example, if the current value of the location counter is 
1000, each of the following statements: 


.=.+40 


or 

.BLKB 40 


or 


.BLKW 20 


reserves 40(8) bytes of storage space in 
.BLKB and .BLKW directives, however, are 
storage space (see Section 6.5.3). 


the source program. The 
the preferred ways to reserve 
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3.7 NUMBERS 


MACRO-11 assumes that all number* i n 

interpreted in octal radix unless nEh source program are to be 
to this assumption is that ooerenHc erw ise specified. An exception 
Processor instructions and Floating Poin^Datf H V ith . Floatin 9 Point 
as decimal (see Section 6.4.2). This defend directives are treated 
with the .RADIX directive see ec2 on Can be alt *red 

numbers can be designated as dULi 6.4.1.1). Also, individual 

temporary radix ?™ berS 

is" not^ifthr^ur^n^'ra'd^x' 6 ,^"?"" th f '° ntoi " s * dl9it th “ 

assembly listing. However MA^RO U • 6 (N) * S generated in the 

statement and evalSatel ea^h iJJh?^ U6S Wlth the scan of the 
value. aiuates each such number encountered as a decimal 

translates suc^numbers into P two ^s^ 3 minus si 9 n ; MACRO-11 

may (but need not) be preceded by a plus sig?? f ° rm ‘ Positive numbers 

177777 (8) )T t is n ^unca?ed f^"th^lef^^d^lf d^- h (greater 
(T) in the assembly listing. f d flagged with an error 

are^eve^'relocatable? 3 * der6 ^ t0 ^ abS ° lute valu ^ therefore. 


than 

code 


they 




the ~ F 
owing format: 


15 

14 

Sign 

8-bit 

Bit 

Exponent 


6 0 

7-bit 

Mantissa 


Refer to the appropriate PDP-11 
floating-point number format"? 


Processor 


Handbook 


for 


details of 


the 


3.8 TERMS 


A term is a 
following: 


component of an expression and may be one of the 


1 . 

2 . 


A number, as defined in Section 3.7 
used, 

A symbol, as defined in Section 3 ? 
as follows: 


whose 16-bit 
Symbols are 


value is 
evaluated 


A. 

B. 


A period (.) specified 
of the current location 


in an expression causes 
counter to be used. 


the 


value 


A defined symbol is 
Table (UST) and its 


located in the 
value is used. 


User-Defined 


Symbol 


C. 


A permanent symbol's basic value is 
substituted for the addressing modes, 
all op codes and their values.) 


used, with zero 
(Appendix C lists 
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D. An T.b 1 le e as°«n Sndefined 

s:?:s?. ?■> ; rF;?" c ti ,s £ .kt; ,, ?!S t .uS;.«ti t ;sK! 

reference default function of MACRO-11 is inhibited, and 
the statement containing the undefined symbol is gg 
with an error code (U) in the assembly listing. 

A single quote followed by a single ASCII character, or a 
doubl! quote followed by two ASCII characters This type of 
expression construction is explained in detail in Section 

6.3.3. 

enclosed llVe^ed “^ced'. .i»$ 

“ s 'z.izxt 1 »y - 

f.SS’to alter the left- to-tIght evaluation of expressions (as 
“ ».|4 “rsSSV<B«» , or to apply a unary operator to an 

entire expression (as in -<A+B>). 

A unary operator followed by a symbol or number. 


3.9 EXPRESSIONS 

SSJs '=s? s s.“ssr l =^a.“ y SM.: f ‘sk.sk 

external, or complex relocatable. 

Expressions are operat^^take^recJdence over 

binary"operators! A term preceded by » a ™«Y°P'^^here necessary, 
before^r use^expressions.) Multiple unary operators are valid 
and are treated as follows:* 


-h—A 


is equivalent to: 

-<+<-A>> 


* The maximum depth of an expression 
assembler's expression stack space, 
assembler's maximum expression depth, 
(E) error, and processing continues. 


is governed by the MACRO 11 
If an expression exceeds the 
the statement is marked with an 
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■ 




<• 

■ 

i 

■ 

!• 


z"ri s . sln i , :siiS pr :; ,1 Si^,“ t * r -; symbo1 is « , 

analysis, causing’error rode!m and/o?'(of "?'"* 1 ' 8 th<! e>: P ressi <> n 
assembly listing depending ™ , 101, be 9 ensr »ted in the 

For example, t^xpres ^? 9 the C °" te,,t ° £ th * axptession itself. 

A + B 177777 
is evaluated as 


A + B 

fS:; Se bfS:“ rSt n °"~ blank character following the symbol B is not a 
operand field tTnlLZ'r ^sellSa" 1 ™ thT^dTf til sTuTce ii° n 


note 

Spaces within expressions can serve as 
delimiters only between symbols. i n 
other words, the expressions 

A + B 

and 

A+B 

are the same, but the symbols 
B17 
and 
B 17 

are not (B 17 is not a single symbol). 


At assembly time the value of an external (global) expression is equal 
to the value of the absolute part of that expression. For example, 
the expression EXTERN+A, where "EXTERN" is an external symbol has a 

time that is equal to the value of &e inJerna! 
(local) symbol A. This expression, however, when evaluated at link 

of m symboi e A.° n ^ reS ° lved value of the s y mbo1 EXTERN, plus the value 

Expressions, when evaluated by MACRO-11, are one of four types- 

relocatable, absolute, external, or complex relocatable The 
following distinctions are important: e - The 


1 . 


An expression is relocatable if its value is fixed relative 
to the base address of the program section in which it 
appears; it will have an offset value added at link time 
that contain labels defined in relocatable progra^ 
sections will have a relocatable value; similarly, a period 
ln a reloc 3table program section, representing the value 
of the current location counter, will also have a relocatable 

V81U6• 


I 
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o An exoression is absolute if its value is fixed. An 
expression whose terms are numbers and ASCII conversion 
characters will reduce to an absolute value. A relocate 
expression or term minus a relocatable term, where both 
elements being evaluated belong to the same program section, 
is an absolute expression. This is because every term in a 
program section has the same relocation bias. When one term 
is "subtracted from another, the resulting bias is zero. 
MACRO-11 can then treat the expression as absolute and reduce 
it to a single term upon completion of the expression scan. 
Terms that contain labels defined in an absolute section will 
also have an absolute value. 

3 An expression is external (or global) if it contains a single 
global reference (plus or minus an absolute expression value) 
that is not defined within the current program. Thus, an 
external expression is only partially defined following 
assembly and must be resolved at link time. 

4. An expression is complex relocatable if any one of the 
following conditions applies: 

- it contains a global reference and a relocatable symbol. 

- It contains more than one global reference. 

- It contains relocatable terms belonging 
program sections. 

- The value resulting from the expression has more than one 

level of relocation. For example, if the relocatable 

symbols TAG1 and TAG2, associated with the same program 
section, are specified in the expression TAG1+TAG2, two 
levels of relocation will be introduced, since each symbol 
is evaluated in terms of the relocation bias in effect for 
the program section. 

- An operation other than addition is specified on an 
undefined global symbol. 

- An operation other than addition, subtraction, negation, or 
complementation is specified for a relocatable value. 

The evaluation of relocatable, external, and complex re^atable 
expressions is completed at link time. The maximum number of terms 


to different 


that can be specified in a complex 
maximum size of the object record, 
(decimal). 


expression is limited by the 
The maximum number of terms is 20 


I 






I 
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CHAPTER 4 


RELOCATION AND LINKING 




To allow the value 
outputs certain 
required paramete 
module, the base 
added to the value 
For external expr 
expression (since 
other object mod 
added to the absol 
by MACRO-11. 


of an expression to be fixed at link time MACRn-il 
ins'ructions in the object file, together ilth “hej 
* fu relocatable expressions in the object 

of thp h rPin^f^ C Ki ted reloc f table program section is 
. the relocatable expression provided by MACRO-11 

ession values, the value of the external ter. in the 
the external symbol must be defined in one of the 
ules being linked together) is determined and then 
te Portion of the external expression, as provided 


All instructions that require modification at link time are f 1 anneH 
apostrophe (?) '^Uowing^the 1 '^^?^xp^nsio^ of^h 16 Th€ 

d ‘ F‘ H- & PBv 


EXAMPLE: 


005065 

000040' 

CLR 

RELOC(R5) 

/Assuming that the value of the 
/symbol "RELOC", 40, is relocatabl 




/the relocation bias 

' w iH ke added to this value. 

005065 

000000G 

CLR 

EXTERN(R5) 

/The value of the symbol "EXTERN" 
/assembled as zero and is 




/resolved at link time. 
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005065 CLR 
0 0000 6G 


005065 CLR 
000000C 


EXTERN+6(R5) 


The value of the symbol EXTERN 
is resolved at link time 
and added to 

the absolute portion (+6) of 
the expression. 


-<EXTERN+RELOC>(R5) ;This expression is complex 
;relocatable because it requires 
;the negation of an expression 
;that contains a global "EXTERN" 

;reference and a relocatable term 


For a complete description of object 
to the applicable system manual (see 


records output by MACRO 11/ 
Section 0.3 in the Preface). 
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CHAPTER 5 


ADDRESSING MODES 


To understand how the add 
action of the program 
remember is: 


ress modes operate and how 
counter must be understood 


they assemble, the 
. The key rule to 


"whenever the processor implicitly uses the program counter 
4 - ? f etc h a word from memory, the proqram counfpr 

completed?"^ inCremented b y 2 a ^r the fetch operation is 


The PC always contains the address of th< 
This word will be either the address 
executed, or the second or third word of 


next word 
of the next 
the current 


to be fetched, 
instruction to be 
instruction. 


Table 5-1 lists the address modes, and 
used in. this chapter to describe 
address in the chapter is illustrated 
instruction CLR or the double operand 


Table 5-2 lists the 
the address modes. Each 
using either the single 
instruction MOV. 


symbols 
mode of 
operand 


Table 5-1 
Addressing Modes 



Mode 


Form 


Section 

Reference 


Register mode* 

Register deferred mode* 
Autoincrement, mode* 
Autoincrement deferred mode* 
Autodecrement mode* 
Autodecrement deferred mode* 
Index mode** 

Index deferred mode** 
Immediate mode** 

Absolute mode** 

Relative mode** 

Relative deferred mode** 
Branch 


R 

@R or (ER) 
(ER) + 

@ (ER) + 
"(ER) 

(ER) 

E (ER) 

@E (ER) 

#E 

@#E 

E 

@E 

Address 


5.1 

5.2 

5.3 

5.4 

5.5 

5.6 

5.7 

5.8 

5.9 

5.10 

5.11 

5.12 

5.13 


** Adds one word to the 
operand of this form. 


instruction length for each occurrence of 


an 
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Table 5-2 

Symbols Used in Chapter 5 



Symbol 


Explanation 
Any expression, as defined in Chapter 3, 


R 


A register expression; in 

expression containing a term 
sign (%) or a symbol previously 
term, as shown below: 


other words, any 
preceded by a percent 
equated to such a 


ER 


R0=%0 ;General register 0. 
R1=R0+1 ;General register 1. 
R2=l+%1 ;General register 2. 


This symbol may also represent any of 
default register definitions (see Section 


the normal 
3.4) . 


A register expression or an absolute expression in 
the range 0 to 7, inclusive. 


5.1 REGISTER MODE 
Format: 

R 

The register itself (R) contains the operand to be manipulated by the 
instruction. 

Example: 

CLR R3 ;Clears register 3. 


5.2 REGISTER DEFERRED MODE 


Format: 

@R or (ER) 

The register (R) contains the address of the operand to be manipulated 
by the instruction. 

Examples: 

CLR @R1 

CLR (Rl) 

C LR (% 1) 


;Al1 these instructions clear 
;the word at the address 
;contained in register 1. 
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5.3 AUTOINCREMENT MODE 
Format: 


(ER) + 


The contents of the register 
being used as the address of 

Examples: 


(ER) are incremented immediately 
the operand (see Note below). 


after 


CLR (R0)+ 

CLR (R4) + 

CLR (R2) + 


;Each instruction clears 
''the word at the address 
/contained in the specified 
/register and increments 
/that register's contents 
/ by two. 


NOTE 


Certain special instruction/address 
combinations, which are rarely or 
used do not operate the same on 
PDP 11 processors, as described bel 


mode 

never 

all 

ow. 


In the autoincrement mode, both the JMP 
an . JSR instructions autoincrement the 
register before its use on the PDP-11/40 
but not on the PDP-ll/45 or 11/10. 


In double operand instructions havinq 
the addressing form Rn,(Rn)+ or 
Rn, (Rn) , where the source and 
destination registers are the same, the 
source operand is evaluated as the 
autoincremented or autodecremented 
value, but the destination register, at 
e time it is used, still contains the 
onginally intended effective address. 

lu th ® followi ng example, as executed on 
the PDP-n/40, Register 0 originally 
contains 100(8): 


MOV R0,(R0)+ 

MOV R0,-(R0) 


/The quantity 102 is moved 
/to location 100. 

/The quantity 76 is moved 
/to location 100. 


The use 
avoided, 
with the 
processors 


of these forms should be 

since they are not compatible 
entire family of PDP-11 


An error code (Z) is printed in the 

^ listin 9 with each instruction 
which is not compatible among all 
members of the PDP-11 family. 
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5.4 AUTOINCREMENT DEFERRED MODE 


Fo rmat: 


@(ER)+ 


The register (ER) 
The contents of 
pointer. 


contains a pointer to the address of 
the register are incremented after 


the operand, 
being used as 


Example: 

CLR @(R3)+ 


;The contents of register 3 point 
;to the address of a word to be 
;cleared before the contents of the 
•register are incremented by two. 


5.5 AUTODECREMENT MODE 
Fo rmat: 


-(ER) 


The contents of the register (ER) are 
the address of the operand (see Note 


decremented before 
in Section 5.3). 


being 


used as 


Examples: 


CLR 

- (R0) 

CLR 

- (R3) 

CLR 

- (R2) 


•Decrement the contents of the speci 
; fied register (0, 3, or 2) by two 
;before using its contents 
; as the address of the word to be 
;cleared. 


5.6 AUTODECREMENT DEFERRED MODE 


Format: 


@-(er) 

The contents of the register (ER) are decremented before being used as 
a pointer to the address of the operand. 


Example: 

CLR @-(R2) 


;Decrement the contents of 
;register 2 by two before 
;using its contents as a pointer 
; to the address of the word to be 
;cleared. 
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5.7 INDEX MODE 
Format: 


ADDRESSING MODES 


E (ER) 


offset of the instruction r\ m’ In other words, the value E is the 
base. (The valJa ^ ’fif ° f r f 9lS “ r ER £ »™ tSl 
third word of the instruction.) 1S stored as th e second or 


Examples: 


CLR 

X+2(Rl) 

MOV 

R0,-2(R3) 


;The effective address of the word 
; t° be cleared is X+2, plus the 
;contents of register 1 . 

;The effective address of the 
,‘destination location is -2, plus 
;the contents of register 3. 


5.8 INDEX DEFERRED MODE 
Format: 


@E(ER) 

An expression (E) , plus the contents of a register (ER) viol< , e 

a^d the'contents'of b °egister 

Example: 


CLR @114(R4) 


,If register 4 contains 100, this 
;value, plus the offset 114, yields 
;the pointer 214. if location 214 
stains the address 2000, location 
,*2000 would be cleared. 


NOTE 


The expr 
will be 
@0(ER), 
the 0 . 


ession @ (ER) may be used, but it 
assembled as if it were written 
and a word will be used to store 
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5.9 IMMEDIATE MODE 
Fo rmat: 


#E 

word! This mode is assembled as an autoincrement of the PC. 


Examples: 

MOV #100,R0 

MOV #X,R0 


;Move the value 100 into register 0. 
•Move the value of symbol X into 
;register 0. 


The operation of this mode can be shown through the first example, 
MOV #100,R0, which assembles as two words: 


Location 20: 012700 


Location 22: 000100 


Location 24: Next instruction 


The source operand 
the instruction 
processor fetches 
that it points 
source operand. 


(the value 100) is assembled immediately following 
word. Upon execution of the instruction, the 
the first word (MOV) and increments the PC by. 2 so 
to the second word, location 22, which contains the 


After the next fetch and increment cycle, 
moved into register 0, leaving the PC 
next instruction). 


the source operand (100) is 
pointing to location 24 (the 


5.10 ABSOLUTE MODE 


Format: 


@#E 


Absolute mode is the equivalent of immediate 
address expression @#E specifies an absolute 
as the second or third word of the instruction, 
value immediately following the instruction 
absolute address of the operand. Absolute mode 
autoincrement deferred of the PC. 


mode deferred. The 
address which is stored 


In 

other 

words. 

the 

word is 

taken as 

the 

is 

assembled as 

an 


Examples: 


MOV 

@#100,R0 

CLR 

@#X 


;Move the contents of absolute 
;location 100 into register R0. 

;Clear the contents of the location 
;whose address is specified by 
;the symbol X. 
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The operation of this mode can be shown through the 
MOV @#100,R0, which assembles as two words: 


first example. 


Location 20: 013700 


Location 22: 000100 


Location 24: Next instruction 

The absolute address 100 is assembled immediately following the 
instruction word. Upon execution of the instruction, the processor 
fetches the first word (MOV) and increments the PC by 2 so that it 
points to the second word, location 22, which contains the absolute 
address of the source operand. After the next fetch and increment 
cycle, the contents of absolute address 100 (the source operand) are 
moved into register 0, leaving the PC pointing to location 24 (the 
next instruction). 


5.11 RELATIVE MODE 
Format: 


E 


Relative mode is the normal mode for memory references within your 
program. It is assembled as index mode, using the PC as the index 
register. The offset for the address calculation is assembled as the 
second or third word of the instruction. This value is added to the 
contents of the PC to yield the address of the source operand. 


Examples: 


CLR 

MOV 


100 
R0 , Y 


;Clear absolute location 100 
;Move the contents of register 0 
;to location Y 


The operation of relative mode can be shown with the statement 
MOV 100,R3, which assembles as two words: 

Location 20: 016703 

Location 22: 000054 

Location 24: NEXT INSTRUCTION 


The offset, the constant 54, is assembled immediately following the 
instruction word. Upon execution of the instruction, the processor 
fetches the first word (MOV) and increments the PC by 2 so that it 
points to the second word, location 22, containing the value 54. 
After the next fetch and increment cycle, the processor calculates the 
effective address of the source operand by taking the contents of 
location 22 (the offset) and adding it to the current value of the PC, 
which now points to location 24 (the next instruction). Thus, the 
source operand address is the result of the calculation 
OFFSET+PC = 54+24 = 100(8), causing the contents of location 100 to be 
moved into register 3. 


I 
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The index mode statement: 

MOV 100-.-4(PC),R3 

is equivalent to the relative mode statement: 

MOV 100 , R3 

100_ - _4 is the offset for the index mode statement. The current 
location counter (.) holds the address of the first word of the 
instruction (20, in this case) and the PC has to move down 4 bytes to 
reach location 24 (the next instruction)• So, the offset could be 
written as 100-20-4 or 54(8). 

Therefore, for the index mode, the offset (54(8)) added to the 
PC (24(8)) yields the effective address (54 + 24 = 100 ( 8 )) of the 
operand. 

Thus, both statements move the contents of location 100 into register 

3. 


NOTE 

The addressing form @#E differs from 
form E in that the second or third word 
of the instruction contains the absolute 
address of the operand, rather than the 
relative distance between the operand 
and the PC (see Section 5.10) . Thus, 
the instruction CLR @#100 clears 
absolute location 100 , even if the 
instruction is moved from the point at 
which it was assembled. See the 
description of the .ENABL AMA function 
in Section 6.2.1, which causes all 
relative mode addresses to be assembled 
as absolute mode addresses. 





5.12 RELATIVE DEFERRED MODE 
Format: 

@E 

The relative deferred mode is similar in operation to the relative 
mode above, except that the expression E is used as a pointer to the 
address of the operand. In other words, the operand following the 
instruction word is added to the contents of the PC to yield a pointer 
to the address of the operand. 

Example: 

MOV @X,R0 ;Relative to the current value of 

;the PC, move the contents of the 
;location whose address is pointed 
;to by location X into register 0. 
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5.13 BRANCH INSTRUCTION ADDRESSING 


The branch instructions are 1-word instructions. The h 

the operator, and the low-order byte contains 
offset (seven bits, plus sign), which specifies the 

hrfn^ Ve ^ t0 thS current value the PC. The hardware 
branch address as follows: 


igh-order byte 
an 8-bit signed 
branch address 
calculates the 


1 . 

2 . 


Extends the sign of the offset through bits 8-15. 

Multiplies the result by 2, creating a byte offset 
than a word offset. 


rather 


3. 


Adds the result to the current value of the PC to 
effective branch address. 


form the 


MACRO-11 performs the reverse operation to form the word offset 
the specified address. 


from 


Word offset - (E-PC)/2 truncated to eight bits. 


When the offset is added to the PC, the PC is moved to the 
(PC-.+2). Hence the -2 in the following calculation. 


next word 


Word offset - (E-.-2J/2 truncated to eight bits. 

The following conditions generate an error code (A) in the assembly 
listing: 1 

1. Branching from one program section to another 

2. Branching to a location that is defined as an external 
(global) symbol 

3. Specifying a branch address that is out of range, meaning 
that the branch offset is a value that does not lie within 
the range -128(10) to +127(10). 


5.14 USING TRAP INSTRUCTIONS 

Since the EMT and TRAP instructions do not use the low-order byte of 
the instruction word, information is transferred to the trap handlers 
in the low-order byte. if the EMT or TRAP instruction is followed by 
an expression, the value of the expression is stored in the low-order 
byte of the word. Expressions greater than 377(8) are truncated to 
eight bits, and an error code (T) is generated in the assembly 
listing. * 

For more information on traps see the PDP-11 Processor Handbook and 
the applicable system manual (see Section 0.3 in the Preface) .- 
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CHAPTER 6 
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GENERAL ASSEMBLER DIRECTIVES 



fi 


A MACRO-11 directive 
Only one directive 
have a blank operand 
differ with each dir 


is placed in 
is allowed 
field or one 
ective. 


the operator field of a source line, 
per source line. Each directive may 
or more operands. Legal operands 


General assembler directives are divided 
categories: 


into the 


following 


1. Listing control 

2. Function control 

3. Data storage 

4. Radix and numeric control 

5. Location counter control 

6. Terminator 

7. Program sectioning and boundaries 

8. Symbol control 

9. Conditional assembly 

10. File control 


Each is described in its own section of this chapter (see Table 6-1 
for an alphabetical listing of the directives and the associated 
section reference) . 


Table 6-1 

Directives in Chapter Six 


Directive 

Function 


Section 

Reference 

.ASCII 

Stores delimited string as 
of the 8-bit ASCII code 
characters. 

a sequence 
of their 

6.3.4 

.ASCIZ 

Same as .ASCII except the 
followed by a zero byte. 

string is 

6.3.5 



(continued 

on next page) 


I 


6-1 











GENERAL ASSEMBLER DIRECTIVES 


Table 6-1 (Cont.) 
Directives in Chapter Six 


Directive 

Function 

Section 

Reference 

.ASECT 

Similar to .PSECT. 

6.7.2 

. BLKB 

Allocates bytes of data storage. 

6.5.3 

. BLKW 

Allocates words of data storage. 

6.5.3 

.BYTE 

Stores successive bytes of data. 

6.3.1 

.CROSS 

Enables cross reference. 

6.2.2 

.CSECT 

Similar to .PSECT. 

6.7.2 

.DSABL 

Disables specified assembler 

functions. 

6.2.1 

.ENABL 

Enables specified assembler functions. 

6.2.1 

.END 

Indicates end of source input. 

6.6 

. ENDC 

Indicates end of conditional assembly 
block. 

6.9.1 

. EVEN 

Ensures that current value of the 
location counter is even. 

6.5.1 

. FLT2 

Generates 2 words of storage for each 
floating-point number argument. 

6.4.2.1 

. FLT4 

Generates 4 words of storage for each 
floating-point number argument. 

6.4.2.1 

.GLOBL 

Defines listed symbols as global. 

6.8.1 

.IDENT 

Provides additional means of labeling 
an object module. 

6.1.4 

.IF 

Assembles block if specified condi¬ 

tions are met. 

6.9.1 

.IFF 

Assembles block if condition tests 
false. 

6.9.2 

. IFT 

Assembles block if condition tests 
true. 

6.9.2 

. IFTF 

Assembles block regardless of whether 
condition tests true or false. 

6.9.2 

. I IF 

Permits writing a one line conditional 
assembly block. 

6.9.3 

.INCLUDE % 

Includes another MACRO-11 source file. 

6.10.2 

.LIBRARY 

Adds file to MACRO-11 library search 

1 ist. 

6.10.1 


(continued on next page) 
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Table 6-1 (Cont.) 
Directives in Chapter Six 


Di rective 


Function 


Section 

Reference 


p 

!• 


.limit 

Allocates two words for storage. At 
link time puts the lowest address of 
the load image in the first of the 
saved words and the address of the 
first free word following the image 
in the second. 

6.5.4 

.LIST 

Increments listing count or lists 

certain types of code. 

6.1.1 

.NLIST 

Decrements listing count or suppresses 
certain types of code. 

6.1.1 

.NOCROSS 

Disables cross reference. 

6.2.2 

.ODD 

Ensures that the current value of the 
location counter is odd. 

6.5.2 

.PACKED 

Generates packed decimal data, two 
digits per byte. 

6.3.8 

• PAGE 

Starts a new listing page. 

6.1.5 

.PSECT 

Declares names for program sections 
and establishes their attributes. 

6.7.1 

.RAD50 

Generates data in Radix-50 packed 

format. 

6.3.6 

.RADIX 

Changes radices throughout or in 

portions of the source program. 

6.4.1.1 

.REM 

Delimits a section of comments. 

6.1.6 

.RESTORE 

Retrieves a previously .SAVEd program 
section. 

6.7.4 

. SAVE 

Places the current program section on 
top of the program section context 
stack. 

6.7.3 

.SBTTL 

Produces a table of contents 
immediately preceding the assembly 
listing and puts subheadings on each 
page in the listing. 

6.1.3 

.TITLE 

Assigns a name to the object module 
and puts headings on each page of 
the assembly listing. 

6.1.2 

.WEAK 

Defines listed symbols as WEAK. 

6.8.2 

• WORD 

Generates successive words of data in 
the object module. 

6.3.2 
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6.1 LISTING CONTROL DIRECTIVES 

Listing control directives control the content, format, and pagination 
of all line printer (see Figure 6-1) and teleprinter (see Figure 6-2) 
assembly listing output. On the first line of each page, MACRO-11 
prints the following (from left to right): 

1 . Title of the object module, as established through the .TITLE 
directive (see Section 6.1.2). 

2. Assembler version identification. 

3. Day of the week. 

4. Date. 


5. Time of day. 


6. Page number. 


The second line of each assembly listing page contains the subtitle 
text specified in the last-encountered .SBTTL directive (see Section 
6.1.3) . 


In the line printer format (Figure 6-1) binary extensions for 
statements generating more than one word are listed horizontally. 

In the teleprinter format (Figure 6-2) binary extensions for 
statements generating more than one word are listed vertically. There 
is no explicit truncation of output to 80 characters by the assembler. 
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6.1.1 .LIST and .NLIST Directives 
Formats: 


■ LIST 

Enlist 


.LIST 

•LIST arg 
•NLIST 
•NLIST arg 


where: arg 


represents one or more of the optional symbolic 
arguments defined in Table 6-2. 


As indicated above, the listing control directives may be used without 
arguments, in which case the listing directives alter the listing 
level count. The listing level count is initialized to zero. At each 
occurrence of a .LIST directive, the listing level count is 

incremented; at each occurrence of an .NLIST directive, the listing 
level count is decremented. When the level count is negative, the 
listing is suppressed (unless the line contains an error) 

Conversely, when the level count is greater than zero, the listing is 

generated regardless of the context of the line. Finally, when the 
count is zero, the line is either listed or suppressed, depending on 
the listing controls currently in effect for the program. The 

following macro definition employs the .LIST and .NLIST directives to 
selectively list portions of the macro body when the macro is 
expanded: 


•MACRO LTEST 


A-this 

line 

should 

list 

. 

NLIST 


B-this 

1 ine 

should 

not list 

• 

NLIST 


C-this 

1 ine 

should 

not list 

. 

LIST 



D-this 

line 

should 

not list 

. 

LIST 



E-this 

line 

should 

list 

F-this 

line 

should 

list 

G-this 

line 

should 

list 

. 

ENDM 




List test 




Listing 

level 

count 

is 

0.. 

Listing 

level 

count 

is 

-1 

Listing 

level 

count 

is 

-2 

Listing 

level 

count 

is 

-1 

Listing 

level 

count 

is 

0. 

Listing 

level 

count 

is 

0. 

Listing 

level 

count 

is 

0. 

Listing 

level 

count 

is 

0. 



• LIST 

ME 


;List macro expansion 

# 


LTEST 



;Call the macro 



A-this 

line 

should 

list 

/Listing level 

count 

is 

0. 

E-this 

line 

should 

list 

/Listing level 

count 

is 

0. 

F-this 

line 

should 

list 

/Listing level 

count 

is 

0. 

G-this 

line 

should 

list 

/Listing level 

count 

is 

0. 


Note that the lines following line E will list because the listing 
level count remains 0. if a .LIST directive is placed at the 
beginning of a program, all macro expansions will be listed unless a 
•NLIST directive is encountered. 
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An important purpose of the level count is to allow macro expansions 
to be listed selectively and yet exit with the listing level count 
restored to the value existing prior to the macro call. 

When used with arguments, the listing directives do not alter the 
listing level count. However, the .LIST and .NLIST directives can be 
used to override current listing control, as shown in the example 
below: 



.MACRO XX 


.LIST 1 ;List next line. 

X=. . , 

.NLIST ;Do not list remainder of macro 

;expansion. 

. ENDM 

.NLIST ME ;Do not list macro expansions. 

XX 

X= • 

The symbolic arguments allowed for use with the listing directives are 
described in Table 6-2. These arguments can be used singly or in 
combination with each other. If multiple arguments are specified in a 
listing directive, each argument must be separated by a comma, tab, or 
space. For any argument not specifically included in the control 
statement, the associated default assumption (List or No list) is 
applicable throughout the source program. The default assumptions for 
the listing control directives also appear in Table 6-2. 




Table 6-2 

Symbolic Arguments of Listing Control Directives 


Argument 

Default 

Function 

SEQ* 

List 

Controls the listing of the sequential 
numbers assigned to the source lines. 

If this number field is suppressed 
through an .NLIST SEQ directive, 
MACRO-11 generates a tab, effectively 



allocating blank space for the field. 
Thus, the positional relationships of 



the other fields in the listing remain 
undisturbed. During the assembly 
process, MACRO-11 examines each source 
line for possible error conditions. 
For any line in error, the error code 
is printed preceding the number field. 


* If the .NLIST arguments SEQ, LOC, BIN, and SRC are in effect at 
the same time, that is, if all four significant fields in the 
listing are to be suppressed, the printing of the resulting blank 
line is inhibited. 

(continued on next page) 
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Argument 
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Table 6-2 (Cont.) 

Symbolic Arguments of Listing Control Directives 
Default Function 


LOC* 


BIN* 


BEX 


SRC* 

COM 


MD 


MC 


List 


List 


List 


List 

List 


List 


List 


MACRO-11 does not assign line numbers 
to files that have had such numbers 
assigned by other programs (an editor 
program, for instance). 

Controls the listing of the current 
location counter field. Normally, 
this field is not suppressed. 
However, if it is suppressed through 
the .NLIST LOC directive, MACRO-11 
does not generate a tab, nor does it 
allocate space for the field, as is 
the case with the SEQ field described 
above. Thus, the suppression of the 
current location counter (LOC) field 
effectively left-justifies all 
subsequent fields (while preserving 
positional relationships) to the 
position normally occupied by the 
counter's field. 

Controls the listing of generated 
binary code. if this field is 
suppressed through an .NLIST BIN 
directive, left-justification of the 


source code field occurs 

in 

the same 

manner described above 
field. 

for 

the LOC 

Controls the listing 

of 

binary 


extensions (the locations and binary 
contents beyond those that will fit on 
the source statement line). This is a 
subset of the BIN argument. 

Controls the listing of source lines. 

Controls the listing of comments. 
This is a subset of the SRC argument. 
The .NLIST COM directive reduces 
listing time and space when comments 
are not desired. 

Controls the listing of macro 
definitions and repeat range 
expansions. 

Controls the listing of macro calls 
and repeat range expansions. 


* If the .NLIST arguments SEQ, LOC, BIN, and SRC are in effect at 

the same time, that is, if all four significant fields in the 
listing are to be suppressed, the printing of the resulting blank 
1 ine is inhibited. 

(continued on next page) 
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Table 6-2 (Cont.) 

Symbolic Arguments of Listing Control Directives 


Argument Default 


Function 


ME 

MEB 


CND 


LD 


TOC 


SYM 


TTM 


No list 


No list 


List 


No list 


List 


List 


No list 


Controls 

expansions 

the 

listing 

of 

macro 

Controls 

the 

listing 

of 

macro 

expansion 

binary 

code. 

A . 

LIST MEB 

directive 

lists 

only 

those 

macro 


expansion statements that generate 
binary code. This is a subset of the 
ME argument. 

Controls the listing of unsatisfied 
conditional coding and associated .IF 
and .ENDC directives in the source 
program. A .NLIST CND directive lists 
only satisfied conditional coding. 

Controls the listing of all listing 
directives having no arguments, in 
other words, the directives that alter 
the listing level count. 

Controls the listing of the table of 
contents during assembly pass 1 (see 
Section 6.1.3 describing the .SBTTL 
directive). This argument does not 
affect the printing of the full 
assembly listing during assembly pass 
2 . 

Controls the listing of the symbol 
table resulting from the assembly of 
the source program. 

Controls the listing output format. 
The default is set to line printer 
format. Figure 6-1 illustrates the 
line printer output format. Figure 
6-2 illustrates the teleprinter output 
format. 


Any argument specified in a .LIST/.NLIST directive other than those 
listed in Table 6-2 causes the directive to be flagged with an error 
code (A) in the assembly listing. 

The listing control options can also be specified at assembly time 
through switches included in the command string to MACRO-11 (see 
Section 8.1.3 and/or the appropriate system manual). The use of these 
switches overrides all corresponding listing control (.LIST or .NLIST) 
directives specified in the source program. 

Figure 6-3 shows a listing, produced in line printer format, 
reflecting the use of the .LIST and .NLIST directives in the source 
program and the effects such directives have on the assembly listing 
output. 
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6.1.2 .TITLE Directive 
Format: 


.TITLE 


.TITLE string 

where: string represents an identifier of 1 or more Radix-50 

characters. Appendix A.2 contains a table of Radix-50 
characters. 

The .TITLE directive assigns a name to the object module. The name 
assigned is the first six non-blank, Radix-50 characters following the 
.TITLE directive. All spaces and/or tabs up to the first 
non-space/non-tab character following the .TITLE directive are ignored 
by MACRO-11 when evaluating the text string. Any characters beyond 
the first six are checked for ASCII legality, but they are not used as 
part of the object module name. For example, the directive: 

.TITLE PROGRAM TO PERFORM DAILY ACCOUNTING 

causes the assembled object module to be named PROGRA. This 
6-character name bears no relationship to the filename of the object 
module, as specified in the command string to MACRO-11. The name of 
an object module (specified in the .TITLE directive) appears in the 
load map produced at link time. This is also the module name which 
the Librarian will recognize. 

If the .TITLE directive is not specified, MACRO-11 assigns the default 
name .MAIN. to the object module. If more than one .TITLE directive 
is specified in the source program, the last .TITLE directive 
encountered during assembly pass 1 establishes the name for the entire 
object module. 

If the .TITLE directive is specified without an object module name, or 
if the first non-space/non-tab character in the object module name is 
not Radix-50 character, the directive is flagged with an error code 
(A) in the assembly listing. 


6.1.3 .SBTTL Directive 

Format: 


• SBTTL 


•SBTTL string 

where: string represents an identifier of 1 or more printable ASCII 

characters. 
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The .SBTTL directive is used to produce a table of contents 
immediately preceding the assembly listing and to print the tex 
following the .SBTTL directive on the second line of the header ot 
each page in the listing. The subheading in the text will be listed 
until altered by a subsequent .SBTTL directive in the program. For 
example, the directive: 


.SBTTL Conditional assemblies 


causes the text 

Conditional assemblies 

to be printed as the second line in the header of the assembly 
listing. 

During assembly pass 1, a table of contents containing the 
sequence number, the page number, and the text accompanying each 
.SBTTL directive is printed for the assembly listing. The listing of 
the table of contents is suppressed whenever an .NLIST TOC directive 
is encountered in the source program (see Table 6-2)• An example of a 
table of contents listing is shown in Figure 6-4. 


MTTEMT - RT-11 MULTI-TTY EMT SE MACRO V05.00 Saturday 08-Jan-83 10100 
TABLE OF CONTENTS 

50- 1 ♦MTOUT - Single character output EMT 

51- 1 ♦MTRCTO - Reset CTRL/0 EMT 

52- 1 .MTATCH - Attach to terminal EMT 

54- i *MTDTCH - Detach from a terminal EMT 

55- l ♦ MTF’RNT - Print message EMT 

56- 1 ♦MTSTAT - Return multi-terminal system status EMT 

57- l MTTIN - Single character input 

58- l MTTGET - Get a character from the ring buffer 

59- l TTRSET - Reset terminal status bits 

60- 1 MTTPUT - Single character output 

62- 1 MTRSET - Stop and detach all terminals attached to a Job 

63- 1 ESCAPE SEQUENCE TEST SUBROUTINE 

Figure 6-4 Assembly Listing Table of Contents 


6.1.4 .IDENT Directive 


Format: 


.IDENT 


.IDENT /string/ 
where: string 


represents a string of six 
characters which establish the 
or version number. This string 
global symbol directory of the object module and 
printed in the link map and librarian listing. 


or fewer Radix-50 
program identification 
is included in the 

is 


6-16 









GENERAL ASSEMBLER DIRECTIVES 


/ / represent delimiting characters. These delimiters may 

be any. paired printing characters, other than the 
equal sign (=), the left angle bracket (<), or the 
semicolon (;), as long as the delimiting character is 
not contained within the text string itself (see Note 

in Section 6.3.4). If the delimiting characters do 

not match, or if an illegal delimiting character is 
used, the .IDENT directive is flagged with an error 
code (A) in the assembly listing. 

In addition to the name assigned to the object module with the TITLE 
directive (see Section 6.1.3), the .IDENT directive allows the user to 
label the object module with the program version number. 

An example of the .IDENT directive is shown below: 

.IDENT /V01.00/ 

The character string is converted to Radix-50 representation and 
included in the global symbol directory of the object module. This 

character.string also appears in the link map produced at link time 

and the Librarian directory listings. 

When more than one .IDENT directive is encountered in a given program, 
the last such directive encountered establishes the character string 
which forms part of the object module identification. 

The RT-11 linker allows only one .IDENT string in a program. The 
linker uses the first .IDENT directive encountered during the first 
pass to establish the character string that will be identified with 
all of the object modules. 

The RSX-11M task builder allows an .IDENT string for each module in 
the program. The TASK Builder uses the first .IDENT directive in each 
module to establish the character string that will be identified with 
that module. Like the RT-11 Linker, the RSX-11M Task Builder uses the 
.IDENT directives encountered on the first pass. 


6.1.5 .PAGE Directive/Page Ejection 
Fo rmat: 


.PAGE 


.PAGE 

The .PAGE directive is used within the source program to perform a 
page eject at desired points in the listing. This directive takes no 
arguments and causes a skip to the top of the next page when 
encountered. It also causes the page number to be incremented and the 
line sequence counter to be cleared. The .PAGE directive does not 
appear in the listing. 

When used within a macro definition, the .PAGE directive is ignored 
during the assembly of the macro definition. Rather, the page eject 
operation is performed as the macro itself is expanded. In this case, 
the page number is also incremented. 
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Page ejection is accomplished in three other ways: 

1. After reaching a count of 58 lines in the listing, MACRO-11 
automatically performs a page eject to skip over page 
perforations on line printer paper and to formulate 
teleprinter output into pages. The page number is not 
changed. 

2. A page eject is performed when a form-feed character is 
encountered. If the form-feed character appears within a 
macro definition, a page eject occurs during the assembly of 
the macro definition, but not during the expansion of the 
macro itself. A page eject resulting from the use of the 
form-feed character causes the page number to be incremented 
and the line sequence counter to be cleared. 

3. A page eject is performed when encountering a new source 
file. In this case the page number is incremented and the 
line sequence count is reset. 




6.1.6 .REM Directive/Begin Remark Lines 


.REM 


Fo rmat: 

.REM comment-character 

where: comment-character represents a character that marks the 

end of the comment block when the 
character reoccurs. 

The .REM directive allows a programmer to insert a block of comments 
into a MACRO-11 source program without having to precede the comment 
lines with the comment character (;). The text between the specified 
delimiting characters is treated as comments. The comments may span 
any number of lines. For example: 

.TITLE Remark example 
.REM & 

All the text that resides here is interpreted by MACRO-11 
to be comment lines until another ampersand character is 
found. Any character may be used in place of the ampersands 
CLR PC 

. END 




6.2 FUNCTION DIRECTIVES 

The following function directives are included in a source program to 
invoke or inhibit certain MACRO-11 functions and operations incidental 
to the assembly process itself. 



I 
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6.2.1 .ENABL and .DSABL Directives 
Fo rmats: 


■ENABL 

.DSABL 


•ENABL arg 
.DSABL arg 

where: arg represents one or more of the optional symbolic 

arguments defined in Table 6-3. 

Specifying any argument in an .ENABL/.DSABL directive other than those 
listed in Table 6-3 causes that directive to be flagged with an error 
code (A) in the assembly listing. 


Table 6-3 

Symbolic Arguments of Function Control Directives 


Argument 

Default 

Function 

ABS 

Disable 

Enabling this function produces absolute 
binary output in FILES-11 format. To 
convert this output to Formatted Binary 
format (as required by the Absolute 
Loader), use the FLX utility. 

AMA 

Disable 

Enabling this function causes all relative 
addresses (address mode 67) to be assembled 
as absolute addresses (address mode 37). 
This function is useful during the 
debugging phase of program development. 

CDR 

Disable 

Enabling this function causes source 
columns from 73 to the end of the line, to 
be treated as a comment. The most common 
use of this feature is to permit sequence 
numbers in card columns 73-80. 

CRF 

Enable 

Disabling this function inhibits the 
generation of cross-reference output. This 
function only has meaning if 
cross-reference output generation is 
specified in the command string. 

FPT 

Disable 

Enabling this function causes floating¬ 
point truncation; disabling this function 
causes floating-point rounding. 

LC 

Enable 

Disabling this function causes MACRO-11 to 
convert all ASCII input to upper-case 
before processing it. 


(continued on next page) 


I 
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Table 6-3 (Cont.) 

Symbolic Arguments of Function Control Directives 


Argument Default 


Function 


I 



LCM Disable This argument, if enabled, causes the 

MACRO-11 conditional assembly directives 
.IF IDN and .IF DIF to be alphabetically 
case sensitive. By default, these 
directives are not case sensitive. 

LSB Disable This argument permits the enabling or 

disabling of a local symbol block. 
Although a local symbol block is normally 
established by encountering a new symbolic 
label, a .PSECT directive or a .RESTORE 
directive in the source program, an .ENABL 
LSB directive establishes a new local 
symbol block which is not terminated until 

(1) another .ENABL LSB is encountered, or 

(2) another symbolic label, .PSECT 
directive or .RESTORE directive is 
encountered following a paired .DSABL LSB 
directive. 

The basic function of this directive with 
regard to .PSECTS is limited to those 
instances where it is desirable to leave a 
program section temporarily to store data, 
followed by a return to the original 
program section. This temporary dismissal 
of the current program section may also be 
accomplished through the .SAVE and .RESTORE 
directives (see Sections 6.7.3 and 6.7.4). 

Attempts to define local symbols in an 
alternate program section are flagged with 
an error code (P) in the assembly listing. 

An example of the .ENABL LSB and .DSABL LSB 
directives, as typically used in a source 
program, is shown in Figure 6-5. 

MCL Disable This argument, if enabled, causes MACRO-11 

to search all known macro libraries for a 
macro definition that matches any undefined 
symbols appearing in the opcode field of a 
MACRO-11 statement. By default, this 
option is disabled. If MACRO-11 finds an 
unknown symbol in the opcode field, it 
either declares a (U) undefined symbol 
error, or declares the symbol an external 
symbol, depending on the .ENABL/.DSABL 
option setting of GBL (described below). 

PNC Enable Disabling this function inhibits binary 

output until an .ENABL PNC statement is 
encountered within the same module. 

(continued on next page) 
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Table 6-3 (Cont.) 

Symbolic Arguments of Function Control Directives 


Argument 


Default 


Function 


REG 


Enable 


When specified, the .DSABL REG directive 
inhibits the normal MACRO-11 default 
register definitions; if not disabled, the 
default definitions listed below remain in 
effect. 

R0 = %0 
R1 = %1 
R2 = %2 
R3 = %3 
R4 = %4 
R5 = %5 
SP=%6 
PC = %7 

The .ENABL REG statement may be used as the 
logical complement of the .DSABL REG 
directive. The use of these 
however, is not recommended, 
consistency, use the normal 
register definitions listed above. 


d i rectives, 
For logical 
default 


GBL 


Enable 



This argument, if disabled, causes MACRO-11 
to mark all undefined references in 
assembly pass 2 with a (U) error in the 
assembly listing. The default for this 
option is enabled, which causes MACRO-11 to 
treat all undefined symbol references as 
global, allowing the linker to resolve 
them. 




.ENABL/ 

.DSABL 

MACRO VOS.00 Saturday 08-Jan-83 

10:26 

Pase 1 


1 

2 





.TITLE 

•ENABL/.DSABL 

3 




f + 




4 

5 




9 ILLUSTRATE . 

t - 

ENABL/.DSABL LC 

6 

7 

8 





•ENABL 

LC 

i STORE MACRO IN LOWER CASE 

9 




•MACRO 

TEXT 

%%% 


10 





.ASCII 

/This 

tit a lower case string/ 

11 




. ENDM 




12 








13 





• LIST 

ME 


14 





.NL1ST 

BEX 


15 








16 

000000 




TEXT 

i s 

i Invoke sacro in lower case 


000000 

124 

150 

151 

.ASCII 

/This 

is a lower case string/ 

17 








18 





•DSABL 

LC 

fNow disable lower case 

19 








20 

000033 




TEXT 

WAS 

JRE-INV0KE MACRO IN UPPER CASE 


000033 

124 

110 

111 

.ASCII 

/THIS 

WAS A LOWER CASE STRING/ 


21 

22 


000001 


.END 




Figure 6-5 Example of .ENABL and .DSABL Directives 
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.CROSS 


.NOCROSS 


6.2.2 Cross-Reference Directives: .CROSS and .NOCROSS 
Fo rmats: 

.CROSS 

.CROSS syml,sym2,...symn 
.NOCROSS 

.NOCROSS syml,sym2 , . . .symn 

where: syml, represents legal symbolic names. When multiple 

sym2, . . . symbols are specified, they are separated by any 
symn legal separator (comma, space, and/or tab). 

The .CROSS and the .NOCROSS directives control which symbols are 
included in the cross-reference listing produced by the MACRO-11 
assembler. These directives have an effect only if the /C[R] or the 
/CROSS qualifier was used in the command line to select the 
cross-reference capability. 

By default, the cross-reference listing includes the definition and 
all the references to every user symbol in the module. The 
cross-reference listing can be disabled for all symbols or for a 
specified list of symbols. 

When the .NOCROSS directive is used without a symbol list, the 
cross-reference listing of all the symbols in the module is disabled. 
The cross-reference listing of all the symbols in the module is 
reenabled when the .CROSS directive is used without a symbol list. 
Any symbol definition or reference that appears after a .NOCROSS 
directive that is used without a symbol list and before the next 
.CROSS directive that is used without a symbol list, is excluded from 
the cross-reference listing. 

The .NOCROSS directive, used with a symbol list, disables the 
cross-reference listing for the listed symbols. When the .CROSS 
directive is used with a symbol list, the cross-reference listing of 
the listed symbols is reenabled. 

In the following example, the definition of LABEL1 and the reference 
to LOCI and L0C2 are not included in the cross-reference listing. 

Example: 

.NOCROSS ;Stop cross reference 

LABEL1: MOV L0C1,L0C2 ?Copy data 

.CROSS ;Reenable cross reference 

In the next example, the definition of LABEL2 and the reference to 
L0C2 are included in the cross reference, but the reference to LOCI is 


not included. 



Example: 

.NOCROSS 

LOCI 

;Do not cross reference LOCI 

LABEL2: 

MOV 

LOCI,L0C2 

;Copy data 


.CROSS 

LOCI 

;Reenable cross reference 
;of LOCI. 


•* 

«p 


•i 

•i 


■ 
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H ^ ' U f ed wlthout a s V mbo1 list, cannot be used to 

l 6 ™ 1 'V tbe cross-reference listing of a symbol specified in the 
symbol list of a .NOCROSS directive. in addition, if the 

the SS CRnlq r ^r 6 l 1Stlng . °f a11 the symbols in a module is disabled, 
the .CROSS directive used with a symbol list will have no effect until 

^h^° SS ~ re K e !; e ?? e 1 lstln< 3 is reenabled by the .CROSS directive used 
without a symbol list. 


The .CROSS directive, with no symbol list, is 
CRF directive, and the .NOCROSS directive 
equivalent to the .DSABL CRF directive. 


equivalent to the .ENABL 
with no symbol list, is 



I 

I 

I 

if 


6.3 DATA STORAGE DIRECTIVES 


A wide range 
directives , 
described in 


of data and data types can be generated with the 
ASCII conversion characters, and radix—control operators 
the following sections. 


6.3.1 .BYTE Directive 
Format: 


.BYTE 


•BYTE exp ;Stores the binary value of the 

/expression in the next byte. 

.BYTE expl,exp2,expn /Stores the binary values of the list 

/of expressions in successive bytes. 


where: exp, represent expressions that must be reduced to 8 bits 

expl, of data or less. Each expression will be read as a 

. 16-bit word expression, the high-order byte to be 

. truncated. The high-order byte must be either all 

. zeros or a truncation (T) error results, 

expn Multiple expressions must be separated by commas. 


The .BYTE directive is used to generate successive bytes of binary 
data in the object module. 


Example: 


SAM=5 

.=410 

.BYTE ~D48 ,SAM 


The value 060 (octal equivalent of 48 
decimal) is stored in location 410. 
The value 005 is stored in location 


411. 


The construction 
illustrates the 
function of such 

6 . 4 . 1 . 2 . 


~D in the first operand of the .BYTE directive above 
use of a temporary radix-control operator. The 
special unary operators is described in Section 


I 
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At link time, it is likely that a relocatable expression will result 
in a value having more than eight bits, in which case the task builder 
or linker issues a truncation (T) error for the object module m 
question. For example, the following statements create such a 
possibility: 

.BYTE 23 ;Stores octal 23 in next byte. 

A: 

.BYTE A ;Relocatable value A will probably 

;cause truncation error. 

If an expression following the .BYTE directive is null, it is 
interpreted as a zero: 


.=420 

.BYTE , ,, ;Zeros are stored in bytes 420, 421, 

;422, and 4 23. 

Note that in the above example, four bytes of storage result from the 
.BYTE directive. The three commas in the operand field represent an 
implicit declaration of four null values, each separated from the 
other by a comma. Hence, four bytes, each containing a value of zero 
(0), are reserved in the object module. 


•> 

4 


6.3.2 .WORD Directive 


.WORD 


Fo rmats: 


.WORD 


exp 


.WORD expi,exp2,expn 


/Stores the binary equivalent of the 
/expression in the next word. 

/Stores the binary equivalents of the 
/list of expressions in successive 
/words. 


where: exp, 

expl. 


expn 


represent expressions that must reduce to 16 bits of 
data or less. Multiple expressions must be separated 
by commas. 


The .WORD directive is used to generate successive words of data in 
the object module. 

Example: 


SAL=0 

.=500 


.WORD 177535,.+4,SAL /Stores the values 177535, 506, and 

/0 in words 500, 502, and 504, 

/respectively. 







i 
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If an expression following the .WORD directive contains a null value, 
is interpreted as a zero, as shown in the following example: 


.=500 

.WORD ,5, 


;Stores the values 0, 5, and 0 in 
;location 500, 502, and 504, 

;respectively. 


A statement with a blank operator field (one that contains a symbol 
other . than a macro call, an instruction mnemonic, a MACRO-11 
directive, or a semicolon) is interpreted during assembly as an 
implicit .VtfORD directive, as shown in the example below: 

.=440 

LABEL: 100,LABEL ;Stores the value 100 in location 440 

;and the value 440 in location 442. 


NOTE 

You should not use this technique to 
generate .WORD directives because it may 
not be included in future PDP-11 
assemblers. 


6.3.3 ASCII Conversion Characters 

The single quote (') and the double quote (") characters are unary 
operators that can appear in any MACRO-11 expression. Used in 
MACRO-11 expressions, these characters cause a 16-bit expression value 
to be generated. 

When the single quote is used, MACRO-11 takes the next character in 
the expression and converts it from its 7-bit ASCII value to a 16-bit 
expression value. The high-order byte of the resulting expression 
value is always zero (0). The 16-bit value is then used as an 
absolute term within the expression. For example, the statement: 

MOV #'A,R0 

moves the following 16-bit expression value into register 0: 


f 000000001 01000001 

t_ 

Binary Value of ASCII A 


Thus the expression 'A results in a value of 101(8). 

The single quote (') character must not be followed by a 
carriage-return, null, RUBOUT, line-feed, or form-feed character; if 
it is, an error code (A) is generated in the assembly listing. 
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When the double quote is used, MACRO-11 takes the next two characters 
in the expression and converts them to a 16-bit binary expression 
value from their 7-bit ASCII values. This 16-bit value is then used 
as an absolute term within the expression. For example, the 
statement: 

MOV #"AB,R0 

moves the following 16-bit expression value into register 0: 


01000010 

01000001 



^ 4 

—Binar; 

f— 

L—Binary Value of ASCII A 

/ Value of ASCII B 


Thus the expression "AB results in a value of 041101(8). 

The double quote (") character, like the single quote (') character, 
must not be followed by a carriage-return, null, RUBOUT, line-feed, or 
form-feed character; if it is, an error code (A) is generated in the 
assembly listing. 

The ASCII character set is listed in Appendix A.l. 


</ 

I 

I 

I 

I 

# 


6.3.4 .ASCII Directive 


•ASCII 


Format: 

.ASCII /string 1/.../string n/ 

where: string is a string of printable ASCII characters. The 

vertical-tab, null, line-feed, RUBOUT, and all other 
non-printable ASCII characters, except carriage-return 
and form-feed, cause an error code (I) if used in an 
.ASCII string. The carriage-return and form-feed 
characters are flagged with an error code (A) because 
these characters end the scan of the line, preventing 
MACRO-11 from detecting the matching delimiter at the 
end of the character string. 

/ / represent delimiting characters. These delimiters may 

be any paired printing characters, other than the 
equal sign (=), the left angle bracket (<), or the 
semicolon (;) (see Note at end of section), as long as 
the delimiting character is not contained within the 
text string itself. If the delimiting characters do 
not match, or if an illegal delimiting character is 
used, the .ASCII directive is flagged with an error 
code (A) in the assembly listing. 



•k 

•i 


■ 
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• ASCI1 dlr ® ct ive translates character strings into their 7-bit 

^nn -lrinl^ U 1 Val t ntS and stores them in the object module. A 
non printing character can be expressed only by enclosing its 

hr^n^ a i ent oct * 1 value within angle brackets. Each set of angle 
rackets so used represents a single character. For example, in the 
following statement: ^ f 


.ASCII <15>/ABC/<A+2>/DEF/<5><4> 


the expressions <15>, <A+2>, <5>, and <4> 
non-printing characters. Each bracketed 
eight bits of absolute data or less. 


represent the values of 
expression must reduce to 


Angle brackets can be embedded between delimiting characters in the 
character string, but angle brackets so used do not take on their 
usual significance as delimiters for non-printing characters. For 
example, the statement: 


.ASCII /ABC<expression>DEF/ 

contains a single ASCII character string, and performs no evaluation 
of the embedded, bracketed expression. This use of the angle brackets 
is shown in the third example of the .ASCII directive below: 

.ASCII /HELLO/ /Stores the binary representation 

;of the letters HELLO in five 
/consecutive bytes. 

.ASCII /ABC/<15XI2>/DEF/ /Stores the binary representation 

/of the characters A,B,C,carriage 
/return,line feed,D,E,F in eight 
/consecutive bytes. 

.ASCII /A<15>B/ /Stores the binary representation 

/of the characters A, <, 1, 5, >, 
/and B in six consecutive bytes. 


NOTE 

The semicolon (/) and equal sign (=) can 
be used as delimiting characters in the 
string, but care must be exercised in so 
doing because of their significance as a 
comment indicator and assignment 
operator, respectively, as illustrated 
in the examples below: 

.ASCII /ABC//DEF/ /Stores the binary 

/representation of 
/the characters 
/A, B, C, D, E, and 
/F in six 

/consecutive bytes/ 
/not recommended 
/practice. 



I 


6-27 









GENERAL ASSEMBLER DIRECTIVES 


.ASCII /ABC/;DEF; ;Stores the binary 

Representations of 
;the characters A, 

;B, and C in three 
;consecutive bytes; 
;the characters D, 

; E, F, and ; are 
;treated as a 
;comment. 

.ASCII /ABC/=DEF= ;Stores the binary 

;representation of 
;the characters A, 
;B, C, D, E, and 
;F in six 

;consecutive bytes; 
;not recommended 
;practice. 

An equal sign is treated as an 
assignment operator when it appears as 
the first character in the ASCII string, 
as illustrated by the following example: 

.ASCII =DEF= ?The direct 

;assignment 
/operation 
;.ASCII=DEF is 
/performed, and a 
/syntax error (Q) 
/is generated upon 
/encountering the 
/second = sign. 


6.3.5 .ASCIZ Directive 


.ASCIZ 


Format: 

.ASCIZ /string 1/.../string n/ 

where: string is a string of printable ASCII characters. The 

vertica1—tab, null, line—feed, RUBOUT, and all other 
non-printable ASCII characters, except carriage-return 
and form-feed, cause an error code (I) if used in an 
.ASCIZ string. The carriage-return and form-feed 
characters are flagged with an error code (A) because 
they end the scan of the line, preventing MACRO-11 
from detecting the matching delimiter. 
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/ / represent delimiting characters. These delimiters may 

be any. paired printing characters, other than the 
equal sign (=), the left angle bracket (<), or the 
semicolon (;) (see Note in Section 6.3.4), as long as 
the delimiting character is not contained within the 
text string itself. If the delimiting characters do 
not match or if an illegal delimiting character is 
used, the .ASCIZ directive is flagged with an error 
code (A) in the assembly listing. 

The .ASCIZ directive is similar to the .ASCII directive described 
above, except that a zero byte is automatically inserted as the final 
character of the string. Thus, when a list or text string has been 
created with an .ASCIZ directive, a search for the null character in 
the last byte can effectively determine the end of the string, as 
reflected by the coding below: 


CR=15 
LF=12 
HELLO: 


10 $: 


ASCIZ <CR><LF>/MACR0-11 V05.00/<CR><LF> introductory message 


;Get address of message. 

;Get address of output buffer. 
;Move a byte to output buffer. 

;If not null, move another byte. 


. EVEN 


MOV 

#HELL0,R1 

MOV 

ILINBUF,R2 

MOVB 

(Rl)+,(R2)+ 

BNE 

10$ 



6.3.6 .RAD50 Directive 

Format: 


.RAD50 


.RAD50 /string 1/.../string n/ 

where: string represents a series of characters to be packed. The 

string must consist of the characters A through Z, 0 
through 9, dollar sign ($), period (.) and space ( ). 
An illegal printing character causes an error flag (Q) 
to be printed in the assembly listing. 

If fewer than three characters are to be packed, the 
string is packed left-justified within the word, and 
trailing spaces are assumed. 
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As with the .ASCII directive (described in Section 
6.3.4), the vertical-tab, null, line-feed, RUBOUT, and 
all other non-printing characters, except 
carriage-return and form-feed, cause an error code (I) 
if used in a .RAD50 string. The carriage-return and 
form-feed characters result in an error code (A) 
because these characters end the scan of the line, 
preventing MACRO-11 from detecting the matching 
delimiter. 


/ / represent delimiting characters. These delimiters may 

be any paired printing characters, other than the 
equal sign (=), the left angle bracket (<), or the 
semicolon (;) (see Note in Section 6.3.4) , provided 
that the delimiting character is not contained within 
the text string itself. If the delimiting characters 
do not match or if an illegal delimiting character is 
used, the .RAD50 directive is flagged with an error 
code (A) in the assembly listing. 


The .RAD50 directive allows the user to generate data in Radix-50 
packed format. Radix-50 form allows three characters to be packed 
into sixteen bits (one word); therefore, any 6-character symbol can 
be stored in two consecutive words. Examples of .RAD50 directives are 
shown below: 


.RAD50 /ABC/ 

.RAD50 /AB/ 

.RAD50 /ABCD/ 

.RAD50 /ABCDEF/ 


;Packs ABC into one word. 

;Packs AB (SPACE) into one word. 

;Packs ABC into first word and 
;D (SPACE) (SPACE) into second word. 
;Packs ABC into first word, DEF into 
;second word. 


Each character is translated into its Radix-50 equivalent, 
indicated in the following table: 


Character Radix-50 Octal Equivalent 

(space) 

A-Z 
$ 

(undefined) 

0-9 

The Radix-50 equivalents for characters 1 through 3 (C1,C2,C3) are 

combined as follows: 

Radix-50 Value = ((Cl*50)+C2)*50+C3 

For example: 

Radix-50 Value of ABC = ((l*50)+2)*50+3 = 3223(8) 

Refer to Appendix A.2 for a table of Radix-50 equivalents. 


0 

1-32 

33 

34 

35 

36-47 


•* 
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fi 

!• 


Angle brackets 
special codes 
example below: 


(<>) must be used in the 
are to be inserted in the 


.RAD50 directive whenever 
text string, as shown in the 


.RAD50 /AB/<35> ;Stores 3255 in one word 

CHR1=1 

CHR2=2 

CHR3=3 


. RAD50 <CHR1XCHR2XCHR3> ,‘Equivalent to . RAD50 /ABC/. 


6.3.7 Temporary Radix-50 Control Operator 


Format: 

~Rccc 


where: ccc 


represents a maximum of three 
converted to a 16-bit Radix-50 
three characters are specified, 
third character are ignored. If 
specified, it is assumed that the 
are blanks. 


characters to be 
value. if more than 
any following the 
fewer than three are 
trailing characters 


The "R operator specifies that an argument is to be converted to 
Radix-50 format. This allows up to three characters to be stored in 
one word. The following example shows how the ~R operator might be 
used to pack a 3-character file type specifier (MAC) into a sinqle 
16-bit word. 


MOV #~RMAC,FILEXT ;Store RAD50 MAC as file extension 


The number sign (#) is used to indicate immediate 
assembled directly into object code). ~R 
characters MAC are to be converted to Radix-50, 
stored in location FILEXT. 


data (data to 
specifies that 
This value is 


be 

the 

then 


5.3.8 .PACKED Directive 
Format: 


.PACKED 


•PACKED decimal-string[,symbol] 

where: decimal-string represents a decimal number from 0 to 

31(10) digits long. Each digit must be in 
the range 0 to 9. The number may have a 
sign, but it is not required and is not 
counted as a digit. 

s y mbo1 is assigned a value equivalent to the 

number of decimal digits in the string. 
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The .PACKED directive generates packed decimal d 
byte. Arithmetic and operational properties of 
similar to those of numeric strings. Below is 
.PACKED directive. 


ata, 2 digits 

packed decimals 
an example of 


per 

are 

the 


.PACKED -12,PACK 
.PACKED +500 
.PACKED 0 
.PACKED -0 ,SUM 
.PACKED 1234E6 


PACK gets value of 2 

500 is packed 

0 is packed 

SUM gets value of 1 

Illegal packed decimal number 

E6 will be treated as a variable 

and given a value of 4 



6.4 RADIX AND NUMERIC CONTROL FACILITIES 
6.4.1 Radix Control and Unary Control Operators 

Any numeric or expression value in a MACRO-11 source program is read 
as an octal value by default. Occasionally, however, an alternate 
radix would be useful. By using the MACRO-11 facilities described 
below, a programmer may declare a radix to affect a term or an entire 
program depending on his needs. 



NOTE 


When two or more unary 
together, modifying 
operators are applied 
right to left. 


operators appear 
the same term, the 
to the term from 



|. RADIX | 

6.4.1.1 .RADIX Directive I J 

Format: 

.RADIX n 

where: n represents one of the three radices: 2, 8 and 10. 

Any value other than null or one of the three 
acceptable radices will cause an error code (A) in the 
assembly listing. If the argument n is not specified, 
the octal default radix is assumed. The argument (n) 
is always read as a decimal value. 

Numbers used in a MACRO-11 source program are initially considered to 
be octal values; however, with the .RADIX directive you can declare 
alternate radices applicable throughout the source program or within 
specific portions of the program. 
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Any alternate radix declared 
directive remains in effect 
such directive, for example: 


in the source program through the 
until altered by the occurrence of 


.RADIX 

another 


.RADIX 10 


;Begins a section of code having a 
/decimal radix. 


.RADIX 


/Reverts to octal radix. 


In general, macro definitions should not contain 
settings established with the .RADIX directive 
radix control operators should be used within a 
Where a possible radix conflict exists within a 
source program, it is recommended that the user 
expression values using the temporary radix 
described below. 


or rely on radix 
• Rather, temporary 
macro definition, 
macro definition or 
specify numeric or 
control operators 


6.4.1.2 Temporary Radix Control Operators 
Formats: 

~D"number" ("number" is evaluated as a decimal number) 

^0 number" ("number" is evaluated as an octal number) 

~B"number" ("number" is evaluated as a binary number) 

These three unary operators allow the user to establish an alternate 
radix for a single term. An alternate is useful because after you 
have specified a radix for a section of code or have decided to use 
the default octal radix, you may discover a number of cases where an 
alternate radix is more convenient or desirable (particularly within 
macro definitions). Creating a mask word (used to check bit status) 
for example, might best be accomplished through the use of a binarv 
radix. 1 


Thus an alternate radix can be declared temporarily to meet a 
localized requirement in the source program. The temporary radix 
control operator may be used any time regardless of the radix in 
effect or other radix declarations within the program. Because the 
operator affects only the term immediately following it, it may be 
used anywhere a numeric value is legal. The term (or expression) 
associated with the temporary radix control operator will be evaluated 
during assembly as a 16-bit entity. 


The expressions below are representative of the methods of 
temporary radix control operators: 


specifying 


~D123 
"0 47 

~B 00001101 
~0<A+13> 


Decimal Radix 
Octal Radix 
Binary Radix 
Octal Radix 


The up-arrow and the radix control operator may not be separated, 
the radix control operator and the following term or expression can 
separated by spaces or tabs for legibility or formatting purposes, 
multi-element term or expression that is to be interpreted in 
alfernsts radix should be enclosed within angle brackets, as shown 
tne last of the four temporary radix control expressions above. 


but 

be 

A 

an 

in 


I 
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The following example also illustrates the use of angle jackets to 
delimit an expression that is to be interpreted in an alternate radix. 
When using the temporary radix control operator only numeric values 
are affected. Any symbols used with the operator will be evaluate 
with respect to the radix in effect at their declaration. 


.RADIX 10 

A=10 

.WORD ~0<A+10 >*10 

When the temporary radix expression in the .WORD directive above is 
evaluated, it yields the following equivalent statement: 


.WORD 180 

MACRO-11 also allows a temporary radix change to decimal by specifying 
a number, immediately followed by a decimal point (.), as shown below: 

100. Equivalent to 144(8) 

1376. Equivalent to 2540(8) 

128. Equivalent to 200(8) 

The above expression forms are equivalent in function to: 

~D100 

~D1376 

~D128 


6.4.2 Numeric Directives and Unary Control Operators 


Two storage directives 
to simplify the use 
These facilities allow 
program, and numeric 
floating-point numbers. 


and two numeric control operators are available 
of the floating-point hardware on the PDP-11, 
floating-point data to be created in the 
values to be complemented or treated as 


A floating-point number is represented by a string of decimal digits. 
The string (which can be a single digit in length) may contain an 
optional decimal point and may be followed by an optional exponent 
indicator in the form of the letter E and a signed decimal integer 
exponent. The number may not contain embedded blanks, tabs or angle 
brackets and may not be an expression. Such a string will result in 
one or more errors (A and/or Q) in the assembly listing. 


The list of numeric representations below contains seven distinct, 
valid representations of the same floating-point number: 


3 

3. 

3.0 
3.0E0 
3E0 
• 3E1 
300E-2 

As can be inferred, the list could be extended indefinitely (3000E-3, 
.0 3E2, and so on). A leading plus sign is optional (3.0 is considered 
to be +3.0). A leading minus sign complements the sign bit. No other 
operators are allowed (for example, 3.0+N is illegal)• 


I 

J 

* 


i 

i 

i 


i 
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All floating-point numbers are evaluated as 64 bits in the followinq 
format: ^ 


63 

S 


62 55 
EEEEEEEE 


54 

MMM, 


0 

.MMM 


may 


Mantissa (55 bits) 

Exponent (8 bits) 

Sign (1 bit) 

MACRO-11 returns a value of the appropriate size and precision via 
of the floating-point directives. The values returned 
truncated or rounded (see Section 6.2.1). 

Floating-point numbers are normally rounded. That 
floating-point number exceeds the limits of the field ii 
to be stored, the high-order bit of the unretained word 
the low-order bit of the retained word, as shown below, 
if the number is to be stored in a 2-word field, but more 
are needed to express its exact value, the highest bil 
unretained field is added to the least significant bit 
retained field (see illustration below). The .ENABL FPT 
used to enable floating-point truncation; .DSABL FPT 
return to floating-point rounding (see Table 6-3). 


one 

be 


s, when 

a 

i which it 

is 

s added 

to 

For example. 

than 32 b 

its 

: (32) of 

the 

(0) of 

the 

d i rective 

is 

is used 

to 


Bit 


Bit Bit 

3 


Bit 

3 


Retained 

field 


Unretained 

field 


All numeric operands associated with Floating Point Processor 
instructions are automatically evaluated as single-word, decimal, 
floating-point values unless a temporary radix control operator is 
specified. For example, to add (floating) the octal constant 41040 to 
the contents of floating accumulator zero, the following instruction 
must be used: 


ADDF #"041040,F0 

where: F0 is assumed to represent floating accumulator zero. 

Floating-point numbers are described in greater detail in the 
applicable PDP-11 Processor Handbook. 


6.4.2.1 Floating-Point Storage Directives 
Formats: 

.FLT2 argl ,arg2,... 

.FLT4 argl,arg2,... 


■FLT2 

FLT4 
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where: argl,arg2,... represent one or more floating-point 

numbers as described in Section 6.4.2, 
Multiple arguments must be separated by 
commas. 

.FLT2 causes two words of storage to be generated for each argument, 
while .FLT4 generates four words of storage for each argument. As in 
the .WORD directive, the arguments are evaluated and the results are 
stored in the object module. 



6.4.2.2 Temporary Numeric Control Operators: ~C and ~F - The C 
unary operator allows you to specify an argument that^is to be 
complemented as it is evaluated during assembly. The F unary 
operator allows you to specify an argument that is a 1-word 
floating-point number. 

As with the radix control operators described above, the numeric 
control operator (~C) can be used anywhere in the source program that 
an expression value is legal. Such a construction is evaluated by 
MACRO-11 as a 16-bit binary value before being complemented. For 
example, the following statement: 

TAG4: .WORD "C151 

causes the l's complement of the value 151 (octal) to be stored as a 
16-bit value in the program. The resulting value expressed in octal 
form is 177626(8). 

Because the ~C construction is a unary operator, the operator and its 
argument are regarded as a term. Thus, more than one unary operator 
may be applied to a single term. For example, the following 
construction: 

~C~D25 

causes the decimal value 25 to be complemented during assembly. The 
resulting binary value, when expressed in octal form, reduces to 
177746(octal). 

The term created through the use of the temporary numeric control 
operator can be used alone or in combination with other expression 
elements. For example, the following construction: 

~C2+6 

is equivalent in function to: 

<~C2>+6 

This expression is evaluated during assembly as a l's complement of 2, 
plus the absolute value of 6. When these terms are combined, the 
resulting expression value generates a carry beyond the most 
significant bit, leaving 000003(8) as the reduced value. 

As shown above, when the temporary numeric control operator and its 
argument are coded as a term within an expression, angle brackets 
should be used as delimiters to ensure precise evaluation and 
readability. 
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F, as stated above, is a unary operator for numeric 
allows you to specify an argument that is a 1-word 
number. For example, the following statement: 


control which 
floating-point 


A: MOV #~F3.7,R0 

creates a 1-word floating-point number at location A+2 containing the 
value 3.7 formatted as shown below. 


BIT 15 


14 7 


6 0 


S 


EEEEEEEE 


MMMMMMM 


Sign (1 bit) Exponent (8 bits) Mantissa (7 bits) 


The importance of ordering with respect to unary operators is shown 
below. 


"F1.0 = 040200 
"F-1.0 = 140200 
-~F1.0 = 137600 
-"F-1.0 = 037600 


The value created by the ~F unary operator and its argument is, like 
~C and its argument, a term that can be used by itself or in an 
expression. For example: 


~C~F6.2 


is equivalent to: 

~C<~F6.2> 

Again, the use of angle brackets is advised. Expressions used as 
terms or arguments of a unary operator must be explicitly grouped. 


fi 

!* 


6.5 LOCATION COUNTER CONTROL DIRECTIVES 

The directives used in controlling the value of the current location 
counter and in reserving storage space in the object program are 
described in the following sections. 

Several MACRO-11 statements (listed below) may cause an odd number of 
bytes to be allocated: 

1. .BYTE directive 

2. .BLKB directive 

3. .ASCII or .ASCIZ directive 

4. .ODD directive 

5. .PACKED directive 

6. A direct assignment statement of the form .=.+expression, 
which results in the assignment of an odd address value. 
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In cases that yield an odd address value, the next word-boundaried 
instruction automatically forces the location counter to an even 
value, but that instruction is flagged with an error code (B) in the 
assembly listing. 


6.5.1 .EVEN Directive 
Fo rmat: 


I .EVEN | 


.EVEN 

The .EVEN directive ensures that the current location counter contains 
an even value by adding 1 if the current value is odd. If the current 
location counter is already even, no action is taken. Any operands 
following an .EVEN directive are flagged with an error code (Q) in the 
assembly listing. 

The .EVEN directive is used as follows: 


.ASCIZ /This is a test/ 

.EVEN ;Ensures that the next statement will 

;begin on a word boundary. 


.WORD XYZ 


j 

«p 


6.5.2 .ODD Directive 
Format: 


|.odd| 


.ODD 

The .ODD directive ensures that the current location counter contains 
an odd value by adding 1 if the current value is even. If the current 
location counter is already odd, no action is taken. Any operands 
following an .ODD directive are also flagged with an error code (Q) in 
the assembly listing. 


6.5.3 .BLKB and 

Formats: 

.BLKB exp 
.BLKW exp 


BLKW Directives 


I.BLKB 

| .BLKW 


•i 


■ 
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ere: exp represents the specified number of bytes or words to be 

reserved in the object program. Any expression that is 
defined at assembly time and that reduces to an 
absolute value is legal. if the expression specified 
in either of these directives is not an absolute value, 
the statement is flagged with an error code (A) in the 
assembly listing. Furthermore, if the expression 
contains a forward reference (a reference to a symbol 
that is not previously defined), MACRO-11 generates 
incorrect object file code and may cause statements 
following the .BLKB/.BLKW directive to be flagged with 
phase (P) errors. These directives should not be used 
without arguments. However, if no argument is present, 
a default value of 1 is assumed. 

The .BLKB directive reserves byte blocks in the object module; the 
.BLKW directive reserves word blocks. Figure 6-6 illustrates the use 
of the .BLKB and .BLKW directives. 


1 

2 

3 


? + 

i Illustrate use 

1 of 

.BLKB and .BLKW directives 

4 

5 

000000 

♦PSECT 

IMPURE * D r GBL » RW 

6 

7 

000000 

COUNT: .BLKW 

1 

'Character counter 

8 

9 

000002 

MESSAG! .BLKB 

80. 

rMessaae text buffer 

10 

11 

000122 

CHRSAVJ .BLKB 


'Saved character 

12 

13 

000123 

FLAG: .BLKB 


'Flag bate 

14 

000124 

msgptr: .BLKW 


'Message buffer pointer 


Figure 6-6 Example of .BLKB and .BLKW Directives 


The .BLKB directive in a source program has the same effect as the 
following statement: 

.=.+expression 

which causes the value of the expression to be added to the current 
value of the location counter. The .BLKB directive, however, is 
easier to interpret in the context of the source code in which it 
appears and is therefore recommended. 


6.5.4 .LIMIT Directive 
Format: 


l-LIMITl 


•LIMIT 

To know the upper and lower address boundaries of the image is often 
desirable. When the .LIMIT directive is specified in the source 
program, MACRO-11 generates the following instruction: 

.BLKW 2 

causing two storage words to be reserved in the object module. Later, 
at link time, the lowest address in the load image (the initial value 
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of SP) is inserted into the first reserved word, and the address of 
the first free word following the image is inserted into the second 

reserved word. 

During linking, the size of the image is rounded upward to the nearest 
2-word boundary. 



.END 

6.6 TERMINATING DIRECTIVE: .END DIRECTIVE -■ * 

Format: 

.END [exp] 

where: exp represents an optional expression value which, if 

present, indicates the program-entry point, which is 
the transfer address where the program begins. 

When MACRO-11 encounters a valid occurrence of the .END directive, it 
terminates the current assembly pass. Any text beyond this point in 
the current source file, or in additional source files identified in 
the command line, will be ignored. 

When creating an image consisting of several object modules, only one 
object module may be terminated with an .END exp statement (where exp 
is the starting address)• All other object modules must be terminated 
with an .END statement (where .END has no argument);, otherwise, an 
error message will be issued at link time. If no starting address is 
specified in any of the object modules, image execution will begin at 
location 1 of the image and immediately fault because of an odd 
addressing error. 

The .END statement must not be used within a macro expansion or a 
conditional assembly block; if it is so used, it is flagged with an 
error code (0) in the assembly listing. The .END statement may be 
used, however, in an immediate conditional statement (see Section 
6.9.3) . 

If the source program input is not terminated with an .END directive, 
an error code (E) results in the assembly listing. 




6.7 PROGRAM SECTIONING DIRECTIVES 

The MACRO-11 program sectioning directives are used to declare names 
for program sections (p-sections) and to establish certain program 
section attributes essential to linking. 
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6.7.1 .PSECT Directive 
Format: 


.PSECT 


.PSECT name,argl,arg2,...argn 


where: name 


r 


represents the symbolic name of the program 
section, as described in Table 6-4. 

represents any legal separator (comma, tab and/or 
space). 


argl, 
arg2,... 
argn 


represent one or more of the legal symbolic 
arguments defined for use with the .PSECT 
directive, as described in Table 6-4. The slash 
separating each pair of symbolic arguments listed 
in the table indicates that one or the other, but 
not both, may be specified. Multiple arguments 
must be separated by a legal separating character. 
Any symbolic argument specified in the .PSECT 
directive other than those listed in Table 6-4 
will cause that statement to be flagged with an 
error code (A) in the assembly listing. 


Table 6-4 

Symbolic Arguments of .PSECT Directive 


Argument 

Default 

Meaning 


NAME 

Blank 

Establishes the program section name, which is 
specified as one to six Radix-50 characters. 

If this argument is omitted, a comma must 
appear in place of the name parameter. The 
Radix-50 character set is listed in Appendix 

A.2. 

RO/RW 

RW 

Defines which type of access is 
the program section: 

permitted to 



RO=Read-Only Access 
RW=Read/Write Access 




NOTE 




RSX-11M and RT-11 use only 
access. 

Read/Write 


(continued on next page) 
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Table 6-4 (Cont.) 

Symbolic Arguments of .PSECT Directive 



Argument Default 


Meaning 


t / D i Defines the contents of the program section: 

I=Instructions. If a p-section has the I 
attribute and the program is overlaid, all 
calls to the p-section are referenced 
through a body of overlay code stored in the 
root. 

If a concatenated p-section has the I 

attribute, code is concatenated on even 
bytes. 

D=Data. If a p-section has the D attribute, 
all calls to the p-section are referenced 
d irectly. 

If a concatenated p-section has the D 

attribute, code is concatenated on the next 
byte regardless of whether the byte is odd 
or even. 

GBL/LCL LCL Defines the scope of the program section, as 

it will be interpreted at link time: 


NOTE 

The GBL/LCL arguments apply only in the 
case of overlays; in building 
single-segment nonoverlaid programs, the 
GBL/LCL arguments have no meaning, 
because the total memory allocation for 
the program will go into the root 
segment of the image. 


LCL=Loca1. If an object module contains a 
local program section, then the storage 
allocation for that module will remain in 
the segment containing the module. Many 
modules can contribute (allocate memory) to 
this same program section; the memory 
allocation for each contributing module is 
either concatenated or overlaid within the 
segment, depending on the allocation 
argument of the program section (see CON/OVR 
below). 

(continued on next page) 
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Table 6-4 (Cont.) 

Symbolic Arguments of .PSECT Directive 


Argument Default 


Meaning 




GBL=Global. if a global program section is 
used in more than one segment of a program, 
all references to the p-section are 
collected across segment boundaries. The 
program sections are then stored in the 
segment (of those originally containing the 
p-sections) that is nearest the root. 


NOTE 

RT-11 stores the collected p-sections in 
the root. 


ABS/REL REL Defines the relocatabi1ity attribute of the 

program section: 

ABS=Absolute (non-relocatable). The ABS 
argument causes the linker or task builder 
to treat the p-section as an absolute 
module; therefore, no relocation is 
required. The program section is assembled 
and loaded, starting at absolute virtual 
address 0. 

The location of data in absolute program 
sections must fall within the virtual memory 
limits of the segment containing the program 
section; otherwise, an error results at 
link time. For example, the following code, 
although valid during assembly, may generate 
an error message (A) if virtual location 
100000 is outside the segment's virtual 
address space: 

.PSECT ALPHA,ABS 

.=.+100000 

.WORD X 

REL=Relocatable. The REL argument causes the 
linker or task builder to treat the 
p-section as a relocatable module and a 
relocation bias is added to all location 
references within the program section making 
the references absolute. 


(continued on next page) 
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Table 6-4 (Cont.) 

Symbolic Arguments of .PSECT Directive 



Argument Default 


Meaning 


CON/OVR CON Defines the allocation requirements of the 

program section: 

CON=Concatenated. All references to one 

program section are concatenated to 
determine the total memory space needed for 
the p-section. 

OVR=Overla id. All references to one program 
section are overlaid; the total memory 
space needed equaling the largest, 
individual p-section. 

SAV/NOSAV NOSAV Determines where the linker allocates storage 

for the program section: 

SAV=Save. The linker is forced to always 
allocate the program section to the root of 
the image. 

NOSAV=No Save. The linker allocates the 
program section normally. 



The only argument in the .PSECT directive that is position-dependent 
is NAME. If it is omitted, a comma must be used in its place. For 
example, the directive: 

.PSECT ,GB L 

shows a .PSECT directive with a blank name argument and the GBL 
argument. Default values (see Table 6-4) are assumed for all other 
unspecified arguments. 

The .PSECT directive may be used without a name or arguments (see 
Section 6.7.1.1). 

The .PSECT directive allows a user to create program sections (see 
Section 6.7.1.1) and to share code and data among the sections he has 
created (see Section 6.7.1.2). In declaring the program sections 
(also called p-sections), you may declare the attributes of the 
p-sections. This allows you to control memory allocation and at the 
same time increases program modularity. (For a discussion of memory 
allocation, refer to the applicable system manual - see Section 0.3 in 
the Preface.) 

MACRO-11 provides for 256(10) program sections, as listed below: 

1. One default absolute program section (. ABS.) 

2. One default relocatable program section (. BLK.)* 


* In RT-11 this program section is unnamed. 





I 


6-44 












GENERAL ASSEMBLER DIRECTIVES 


■ 


*Q 



3. Two-hundred-fifty-four named program sections. 

For each program section specified or implied, MACRO-11 
following information: 

1. Program section name 

2. Contents of the current location counter 

3. Maximum location counter value encountered 

4. Program section attributes (described in Table 


maintains the 


6-4 above). 


6.7.1.1 Creating Program Sections - The 
program is always an implied .PSECT di 
to begin assembling source statements 
unnamed program section. 


first statement of a source 
rective; this causes MACRO-11 
at relocatable zero of the 


IJ* It occurrence i °f ^ .PSECT directive with a given name assumes 
that the current location counter is set at relocatable zero. The 
scope of this directive then extends until a directive declarinq a 
different program section is specified. Subsequent .PSECT directives 
cause assembly to resume where the named section previously ended 
For example: 


.PSECT 

A: .WORD 0 

B: .WORD 0 

C: .WORD 0 

.PSECT ALPHA 
X: .WORD 0 

Y: .WORD 0 

.PSECT 

D: .WORD 0 


;Declares unnamed relocatable program 
;section assembled at relocatable 
/addresses 0 through 5. 

/Declares relocatable program section 
/named ALPHA assembled at relocatable 
/addresses 0 through 3. 

/Returns to unnamed relocatable 
/program section and continues assem- 
/bly at relocatable address 6. 


A given program section may be defined completely upon encountering 
its first .PSECT directive. Thereafter, the section can be referenced 
by specifying its name only, or by completely respecifying its 
attributes. For example, a program section can be declared throuqh 
the directive: 


.PSECT ALPHA,ABS,OVR 

and later referenced through the equivalent directive: 

.PSECT ALPHA 

which requires no arguments. If arguments are specified, they must be 
identical to the ones previously declared for the p-section. If the 
arguments differ, the arguments of the first .PSECT will remain in 
effect, and an error code (A) will be generated as a warning. 
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By maintaining separate location counters for each program section, 
MACRO-11 allows you to write statements that are not physically 
sequential but that can be loaded sequentially following assembly, as 
shown in the following example. 


A 

B 

C 


ST: 


.PSECT SEC1,REL,RO 

.WORD 0 

.WORD 0 

.WORD 0 

CLR A 

CLR B 

CLR C 

.PSECT SECA,ABS 

.WORD .+2,A 
.PSECT SEC1 
INC A 
BR ST 


;Start a relocatable program section 
;named SEC1 assembled at relocatable 
;addresses 0 through 5. 

;Assemble code at relocatable 
;addresses 6 through 21(8). 

;Start an absolute program section 
;named SECA. Assemble code at 
;absolute addresses 0 through 3. 

;Resume relocatable program section 
;SEC1. Assemble code at relocatable 
;addresses 22 through 27(8). 


All labels in an absolute program section are absolute; likewise, all 
labels in a relocatable section are relocatable. The current location 
counter symbol (.) is relocatable or absolute when referenced in a 
relocatable or absolute program section, respectively. 


Any labels appearing on a line containing a 
.CSECT) directive are assigned the value 
counter before the .PSECT (or other) directive 
the first statement of a program is: 


.PSECT (or .ASECT or 
of the current location 
takes effect. Thus, if 


A: .PSECT ALT,REL 

the label A is assigned to relocatable address zero of the unnamed 
program section. 

Since it is not known during assembly where relocatable program 
sections will be loaded, all references to relocatable program 
sections are assembled as references relative to the base of the 
referenced section. 


In the following example, references to the symbols X and Y are 
translated into references relative to the base of the relocatable 
program section named SEN. 


.PSECT ENT,ABS 

.=.+1000 

A: CLR X 

JMP Y 

.PSECT SEN,REL 
MOV R0,R1 

JMP A 

Y: HALT 

X: .WORD 0 


;Assembled as CLR base of 
;relocatable section + 10(8). 
;Assembled as JMP base of 
Relocatable section + 6(8). 


;Assembled as JMP 1000. 
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NOTE 

In the preceding example, using a 
constant in conjunction with the current 
location counter symbol (.) in the form 
.-1000 would result in an error, because 
constants are always absolute and are 
always associated with the program's 
.ASECT (. ABS.). if the form .=1000 
were used, a program section 
incompatibility would be detected. See 
Section 3.6 for a dicussion of the 
current location counter. 

Thus, MACRO-11 provides the linker or task builder with the necessary 

sSch r information re r 1Ve linkages between various program sections. 
fbSol..?f « n ° necessary, however, when referencing an 
Drooram sectl01 ?' because all instructions in an absolute 
program section are associated with an absolute virtual address. 


Code or Data Sharing - Named relocatable program sections 

pnMMAM th !L ar< 3 uments GBL and °VR operate in the same manner as FORTRAN 
COMMON, that is, program sections of the same name with the arguments 
GBL and OVR from different assemblies are all loaded at the same 

aranmpnt- ~™n lnk tlme ‘ . A11 °5 her program sections (those with the 
argument CON) are concatenated. 

A single symbol could name both an internal symbol and a program 
section. Considering FORTRAN again, using the same symbolic name is 
necessary to accommodate the following statement: 

COMMON /X/ A,B ,C ,X 

where the symbol X represents the base of the program section and also 
the fourth element of that section. 


6.7.1.3 Memory Allocation Considerations - The assembler does not 
generate an error when a module ends at an odd location. You can, 
therefore, place odd length data at the end of a module. However, 
when several modules contain object code contributions to the same 
program section having the concatenate attribute (see Table 6-4- 



sepai 

jram 
then 

- section on an even address. Refer to the 

applicable system manual for further informatic 
of tasks (see Section 0.3 in the Preface). 


ata from each other and place them in separately named proqr 
sections (see Table 6-4; I/D). The linker or task builder can tl 
begin each program section on an even ac 

Lon on memory allocation 
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6.7.2 .ASECT and .CSECT Directives 


■ASECT 

.CSECT 


Formats: 


.ASECT 

.CSECT 

.CSECT symbol 


where: symbol represents one or more of the arguments in Table 6 4. 


IAS and RSX-11M assembly-language programs use the.PSECT and 
directives exclusively, because the .PSECT directive provides 
capabilities of the .CSECT directive defined for other 
assemblers. MACRO-11 will accept both .ASECT and .CSECT dire 
but assembles them as though they were .PSECT directives wi 
default attributes listed in Table 6-5. Compatibility exists 
other MACRO-11 programs and the IAS/RSX-11M Task Builders, beca 
Task Builders also treat the .ASECT.and .CSECT directives like 
directives with the default values listed in Table 6-5. 


.ASECT 
all the 
PDP-11 
ct ives, 
th the 
between 
use the 
.PSECT 


Table 6-5 

Program Section Default Values 


Attribute 


Default Value 



.ASECT 

.CSECT (named) .CSECT (unnamed) 

Name 

. ABS. 

name 

. BLK.* 


ACCESS 

RW 

RW 

RW 


Type 

I 

I 

I 


Scope 

GBL 

GBL 

LCL 


Relocation 

ABS 

REL 

REL 


Allocation 

OVR 

OVR 

CON 


* In RT-11 this 

program 

section has no default 

name. 



«p 

j 



Note that the statement: 

.CSECT JIM 

is identical to the statement: 

.PSECT JIM,GBL,OVR 

because the .CSECT default values GBL and OVR are assumed for the 
named program section. 
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6,7.3 .SAVE Directive 
Format: 


■SAVE | 


• SAVE 


.SAVE stores the current program section context on the top 
program section context stack, while leaving the current 
section context in effect. If the stack is full when .SAVE is 
an error (A) occurs. The stack can handle 16 .SAVES. The 
section context includes the values of the current location 
and the maximum value assigned to the location counter in the 
program section. 


to the 
program 
issued, 
program 
counter 
current 


See Figure 6-7 for an example of .SAVE. 


6.7.4 .RESTORE Directive 
Format: 

.RESTORE 


l-RESTOREl 


The .RESTORE directive retrieves the program section from the top of 
the program section context stack. If the stack is empty when 
.RESTORE is issued, an error (A) occurs. When .RESTORE retrieves a 
program section, it restores the current location counter to the value 
it had when the program section was saved. 

See Figure 6-7 for an example of .RESTORE. 
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6.8 SYMBOL CONTROL DIRECTIVES 


The symbol control directives are used to set the 
symbol. 


type of a 


given 




6.8.1 .GLOBL Directive 
Format: 


.GLOBL 


.GLOBL syml,sym2,...symn 

where: syml, represent legal symbolic names. When multiple 

sym2,... symbols are specified, they are separated by any 
s y mn legal separator (comma, space, and/or tab). 

A .GLOBL directive may also embody a label field and/or a comment 
field. 

The .GLOBL directive is provided to define (and thus provide linkage 
to) symbols not otherwise defined as global symbols within a module. 
In defining global symbols the directive .GLOBL A,B,C is similar to: 

A==:expression A==expression A:: 

B==:expression or B==expression or B:: 

C==:expression C==expression C:: 

Because object modules are linked by global symbols, these symbols are 
vital to a program. The following paragraph, describing the 
processing of a program from assembly to linking, explains the 
global's role. 

In assembling a source program, MACRO-11 produces a relocatable object 
module and a listing file containing the assembly listing and symbol 
table. The linker or task builder joins separately assembled object 
modules into a single executable image. During linking, object 
modules are relocated relative to the base of the module and linked by 
global symbols. Because these symbols will be referenced by other 
program modules, they must be singled out as global symbols in the 
defining modules. As shown above, the .GLOBL directive, global 
assignment operator, or global label operator will define a symbol as 
global. 

All internal symbols appearing within a given program must be defined 
at the end of assembly pass 1 or they will be assumed to be default 
global references. Refer to Section 6.2.1 for a description of 
enabling/disabling of global references. 
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In the following example, A and B are entry-point symbols. The symbol 
A has been explicitly defined as a global symbol by means of the 
.GLOBL directive, and the symbol B has been explicitly defined as a 
global label by means of the double colon Since the symbol C is 
not defined as a label within the current assembly, it is an external 
(global) reference if .ENABL GBL is in effect. 


Define a subroutine with 2 entry points which calls an 
external subroutine 



.PSECT 


;Declare the unnamed program section. 


.GLOBL 

A 

;Define A as a global symbol. 

A: 

MOV 

@(R5)+,R0 

;Define entry point A. 


MOV 

#X,R1 

;Call external subroutine C. 

X: 

JSR 

PC,C 


RTS 

R5 

;Exit. 

B: : 

MOV 

(R5)+,R1 

;Define entry point B. 


CLR 

R2 



BR 

X 



External symbols can appear in the operand field of an instruction or 
MACRO-11 directive as a direct reference, as shown in the examples 
below: 

CLR EXT 
.WORD EXT 
CLR @EXT 

External symbols may also appear as a term within an expression, as 
shown below: 

CLR EXT+A 
.WORD EXT-2 
CLR @EXT+A(R1) 

An undefined external symbol cannot be used in the evaluation of a 
direct assignment statement or as an argument in a conditional 
assembly directive (see Sections 3.3, 6.9.1 and 6.9.3). 


6.8.2 .WEAK Directive 


.WEAK 


Format: 


.WEAK syml,sym2,...symn 


where: syml 

sym2,... 
symn 


Example: 


represents legal symbolic names. When multiple 
symbols are specified, they are separated by any 
legal separator (comma, space, and/or tab). 


.WEAK SUB1,SUB2 


The .WEAK directive may also embody a label 
field. 


field and/or a comment 


«p 

e> 
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The .WEAK directive is used to specify symbols that are 
externally in another module or defined globally 
module. This directive suppresses object library 
specified external symbols. 


either defined 
in the current 
searches for 


When the .WEAK directive specifies a symbol that is externally 
defined, it is considered a global symbol. if the linker finds the 
symbol s definition in another module, it uses that definition. If 
the linker does not find an external definition, the symbol is given a 
vaiue of 0. The linker does not search a library for the global 
symbol, but if a module brought in from a library for another reason 
contains the symbol s definition, the linker uses that definition. 


If a symbol that is defined in the current module is specified by the 
.WEAK directive, the symbol is considered globally defined. However, 
if the current module is inserted in an object library, the symbol is 
not inserted in the library's symbol table. Consequently, the module 
is not found when the library is searched at link time to resolve the 
symbol. 


NOTE 

The .WEAK directive is only supported by 
the RT-11 V5.0 LIBRARIAN (LIBR) and 
LINKER (LINK). Support is not yet 
implemented in the RSX-11 taskbuilder 
(TKB) or librarian (LBR). 



6.9 


CONDITIONAL ASSEMBLY DIRECTIVES 


Conditional assembly directives allow you to include or exclude blocks 
of source code during the assembly process, based on the evaluation of 
stated condition tests within the body of the program. 







.IF 


6.9.1 Conditional Assembly Block Directives 
Format: 


• ENDC 


1 IF cond,argument(s) ;Start conditional assembly block. 


range 


. ENDC 


;Range of conditional assembly block. 


;End of conditional assembly block. 
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where: cond represents a specified condition that must be 

met if the block is to be included in the 
assembly. The conditions that may be tested by 
the conditional assembly directives are defined 
in Table 6-6. 


represents any legal separator (comma, space, 
and/or tab). 


argument(s) represent(s) the symbolic argument(s) or 
expression(s) of the specified conditional test. 
These arguments are thus a function of the 
condition to be tested (see Table 6-6). 


range represents the body of code that is either 

included in the assembly, or excluded, depending 
upon whether the condition is met. 

.ENDC terminates the conditional assembly block. This 

directive must be present to end the conditional 
assembly block. 


A condition test other than those listed in Table 6-6, an illegal 
argument, or a null argument specified in an .IF directive causes that 
line to be flagged with an error code (A) in the assembly listing. 


•> 

4 


Table 6-6 

Legal Condition Tests for Conditional Assembly Directives 


Conditions 



Positive 

Complement 

Arguments 

Assemble Block If: 

EQ 

NE 

Expression 

Expression is equal to 0 
(or not equal to 0). 

GT 

LE 

Expression 

Expression is greater 
than 0 (or less than or 
equal to 0). 

LT 

GE 

Expression 

Expression is less than 0 
(or greater than or equal 
to 0) . 

DF 

NDF 

Symbolic 
argument 

Symbol is defined (or not 
defined). 

B 

NB 

Macro-type 
a rgument 

Argument is blank (or 

non-blank). 


(continued on next page) 
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Table 6-6 (Cont.) 

Legal Condition Tests for Conditional Assembly Directives 
Conditions 


Positive Complement Arguments 


Assemble Block If: 


IDN 

DIF 

Two macro-type 

Arguments are 

identical 



a rguments 

(or different). 

The .IF 




IDN/.IF DIF conditional 




d i rectives 

are not 




alphabetically 

case 




sensitive by 

default. 




The user may enable these 




directives to 

be case 




sensitive by 

using the 




.ENABL option 

LCM) . 

( .ENABL 



NOTE 

A macro-type argument (which is a form 
of symbolic argument), as shown below, 
is enclosed within angle brackets or 
denoted with an up-arrow construction 
(as described in Section 7.3). 

<A,B,C> 

V124/ 


An example of a conditional assembly directive follows: 
•IF EQ ALPHA+1 /Assemble block if ALPHA+1=0 


fi 

!• 


. ENDC 

The two operators & and ! have special meaning within DF and NDF 
conditions, in that they are allowed in grouping symbolic arguments. 

& Logical AND operator 

! Logical inclusive OR operator 

For example, the conditional assembly statement: 

.IF DF SYM1 & SYM2 

.ENDC 

results in the assembly of the conditional block if the symbols SYM1 
and SYM2 are both defined. 
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Nested conditional directives take the form: 

Conditional Assembly Directive 
Conditional Assembly Directive 



. ENDC 
. ENDC 

For example, 

.IF DF 
.IF DF 


the following 

SYM1 

SYM2 


conditional 


directives: 


.ENDC 

.ENDC 

can govern whether assembly is to occur. In the example above, if the 
outermost condition is unsatisfied, no deeper level of evaluation of 
nested conditional statements within the program occurs. 

Each conditional assembly block must be terminated with an .ENDC 
directive. An .ENDC directive encountered outside a conditional, 
assembly block is flagged with an error code (0) in the assembly 
1isting. 

MACRO-11 permits a nesting depth of 16(10) conditional assembly 
levels. Any statement that attempts to exceed this nesting level 
depth is flagged with an error code (0) in the assembly listing. 




6.9.2 Subconditional Assembly Block Directives 



.IFF 

.IFT 

.IFTF 


Formats: 

.IFF 

• IFT 

. IFTF 

Subconditional directives may be placed within conditional assembly 
blocks to indicate: 

1. The assembly of an alternate body of code when the condition 
of the block tests false. 

2. The assembly of a non-contiguous body of code within the 
conditional assembly block, depending upon the result of the 
conditional test in entering the block. 

3. The unconditional assembly of a body of code within a 
conditional assembly block. 


•i 

«i 


i 
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The subconditional directives are described in detail in Table 6-7. 
It a subconditional directive appears outside a conditional assembly 
block, an error code (0) is generated in the assembly listing. 

Table 6-7 

Subconditional Assembly Block Directives 

Subconditional 

Di rective 

Function 

. IFF 

If the condition tested upon entering the 

conditional assembly block is false, the code 
following this directive, and continuing up to the 
next occurrence of a subconditional directive or to 
the end of the conditional assembly block, is to be 
included in the program. 

. IFT 

If the condition tested upon entering the 
conditional assembly block is true, the code 
following this directive, and continuing up to the 
next occurrence of a subconditional directive or to 
the end of the conditional assembly block, is to be 
included in the program. 

. IFTF 

The code following this directive, and continuing up 
to the next occurrence of a subconditional directive 
or to the end of the conditional assembly block, is 
to be included in the program, regardless of the 
result of the condition tested upon entering the 
conditional assembly block. 


The implied argument of a subconditional directive is the condition 
test specified upon entering the conditional assembly block, as 
reflected by the initial directive in the conditional coding examples 
below. Conditional or subconditional directives in nested conditional 
assembly blocks are not evaluated if the previous (or outer) condition 
in the block is not satisfied. Examples 3 and 4 below illustrate 
nested directives that are not evaluated because of previous 
unsatisfied conditional coding. 

EXAMPLE Is Assume that symbol SYM is defined. 

.IF DF SYM ;Tests TRUE, SYM is defined. Assemble 

• ;the following code. 


;Tests FALSE. SYM is defined. Do not 
/assemble the following code. 


/Tests TRUE. SYM is defined. Assem- 
/ble the following code. 


. IFTF 


/Assemble following code uncondition¬ 
ally. 
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. IFT 


. ENDC 


Tests TRUE. SYM is defined. Assem¬ 
ble remainder of conditional assem¬ 
bly block. 


EXAMPLE 2: Assume that symbol X is defined and that symbol Y is not 
defined. 


.IF DF X 
.IF DF Y 
. IFF 


;Tests TRUE, symbol X is defined. 

;Tests FALSE, symbol Y is not defined. 
;Tests TRUE, symbol Y is not defined, 
;assemble the following code. 


.IFT 


;Tests FALSE, symbol Y is not defined. 
;Do not assemble the following code. 


.ENDC 
. ENDC 

EXAMPLE 3: Assume that symbol A is defined and that symbol B is not 
defined. 


.IF DF A 
MOV A,AR1 


;Tests TRUE. A is defined. 
;Assemble the following code. 


.IFF 

MOV R1,R0 


;Tests FALSE. A is defined. Do not 
/assemble the following code. 


.IF NDF B 


/Nested conditional directive is not 
/evaluated. 


.ENDC 

.ENDC 

EXAMPLE 4: Assume that symbol X is not defined and that symbol Y is 
defined. 

.IF DF X /Tests FALSE. Symbol X is not defined. 

/Do not assemble the following code. 

.IF DF Y /Nested conditional directive is not 

. /evaluated. 


IFF 


/Nested subconditional directive is 
/not evaluated. 


.IFT 


/Nested subconditional directive is 
/not evaluated. 


. ENDC 
.ENDC 
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6.9.3 Immediate Conditional Assembly Directive 
Format: 

.IIF cond,arg,statement 

represents one of the legal condition tests defined 
for conditional assembly blocks in Table 6-6. 

represents any legal separator (comma, space, 
and/or tab). 

represents the argument associated with the 

immediate conditional directive; an expression, 
symbolic argument, or macro-type argument, as 
described in Table 6-6. 

represents the separator between the conditional 
argument and the statement field. if the preceding 
argument is an expression, then a comma must be 
used; otherwise, a comma, space and/or tab may be 
used. 

statement represents the specified statement to be assembled 
if the condition is satisfied. 

An immediate conditional assembly directive provides a means for 

writing a 1-line conditional assembly block. The use of this 
directive requires no terminating . ENDC statement and the condition to 
be tested is completely expressed within the line containinq the 
directive. 

For example, the immediate conditional statement: 

.IIF DF F00,BEQ ALPHA 

generates the code 
BEQ ALPHA 

if the symbol F00 is defined within the source program. 

t S v^ lth ^ e * IF d * rective ' a condition test other than those listed in 
T tto^• an ille 9 a l argument, or a null argument specified in an 

.IIF directive results in an error code (A) in the assembly listing. 


where: cond 


arg 




I 
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6.10 FILE CONTROL DIRECTIVES 

The MACRO-11 file control directives are used to add file names to 
macro library lists and to insert a source file into the source file 
being currently used. 


I 



6.10.1 .LIBRARY Directive 


.LIBRARY 


Format: 

.LIBRARY string 

where: string represents a delimited string that is the file 

specification of a macro library. 

The .LIBRARY directive adds a file name to a macro library list that 
is searched. A library list is searched whenever a .MCALL or an 
undefined opcode is encountered within a MACRO-11 program. The 
libraries that make up the list are searched in the reverse order in 
which they were specified to the MACRO-11 assembler. 

If any information was omitted from the macro library argument, 
default values are assumed. The default file specification for 
MACRO-11/RT-11 is DK: .MLB, and for other systems it is SY:.MLB. 

The .LIBRARY directive is used as follows: 

.LIBRARY /DB1:[SMITH]USERLIB/ 

.LIBRARY ?DK:SYSDEF.MLB? 

.LIBRARY \CURRENT.MLB\ 

MACRO-11 searches all macro libraries if it finds an unknown symbol in 
the opcode field and the auto-mcall option has been previously enabled 
by .ENABL MCL. 


NOTE 

If you are using MACRO-11 with an RT-11 
operating system, you should be aware of 
the following two restrictions. The 
device driver for the specified device 
that the .LIBRARY file resides on must 
already be loaded, either explicitly 
with the KMON LOAD command, or 
implicitly by reference to the device on 
the original MACRO-11 command line. The 
second restriction is that there is a 
limit on the number of .LIBRARY files 
that may be specified. The limit is 
twelve minus the number of files 
specified in the MACRO-11 command line. 
Since there can be a maximum of eight 
files on a MACRO-11/RT-11 command line, 
there are at least four available slots 
for .LIBRARY files. 



•k 

•1 


■ 
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6.10.2 .INCLUDE Directive 
Format: 


•INCLUDE 


.INCLUDE string 

where: string represents a delimited string that is the file 

specification of a macro source file. 

The .INCLUDE directive is used to insert a source file within the 
source file currently being used. When this directive is encountered, 
the current source file is stacked and the source file specified by 
the directive is read into memory. When the end of the specified 
source file is reached, the original source file is popped from the 
stack and assembly resumes at the line following the directive. A 
source file can also be inserted within a source file that has already 
been specified by the .INCLUDE directive. In this case the original 
source file and the first source file specified by the .INCLUDE 
directive are stacked and the second specified source file is read 
into memory. When the end of the second source file is reached, the 
first specified source file is popped from the stack and assembly 
resumes at the line following the directive, and when the end of the 
specified source file is reached, the original source file is 
popped from the stack and assembly of that file is started again at 
the line following the .INCLUDE directive. The maximum nesting level 
of source files specified by the .INCLUDE directive is five. 

If any information is omitted from the source file argument, default 
values are assumed. The default file specification for MACRO-11/RT-l1 
is DK:.MAC, and for other systems it is SYi.MAC. 

The .INCLUDE directive is used as follows: 

•INCLUDE /DR3:[1,2]MACROS/ ;File MACROS.MAC 

.INCLUDE ?DK:SYSDEF? 

.INCLUDE \CURRENT.MAC\ 


NOTE 

If you are using MACRO-11 with an RT-11 
operating system, the device driver for 
the specified device that the .INCLUDE 
file resides on must already be loaded, 
either explicitly with the KMON LOAD 
command, or implicitly by reference to 
the device on the original MACRO-11 
command line. 
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MACRO DIRECTIVES 



fi 
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7.1 DEFINING MACROS 


By using macros a programmer can use a single 
sequence of lines into a source program. 


line to insert a 


A macro definition is headed by a .MACRO directive 
followed by the source lines. The source lines may 
dummy arguments. If such arguments are used, each 
the .MACRO directive. 


(see Section 7.1. 
optionally conta 
one is listed 


1 ) 

in 

in 


A macro call (see Section 7. 
to call the macro into the 
name followed by the real 
arguments used in the macro. 


3) is the statement used by the programmer 
source program. it consists of the macro 
arguments needed to replace any dummy 


Macro expansion is the insertion of the macro 
main program. Included in this insertion 
dummy arguments by the real arguments. 


source lines into 
is the replacement of 


the 

the 


Macro directives provide the means to manipulate the 
Only one directive is allowed per source line, 
have a blank operand field or one or more operands, 
differ. with each directive. The macros and 
directives are detailed in this chapter. 


macro expansions. 
Each directive may 
Legal operands 
their associated 


7.1.1 .MACRO Directive 
Format: 


.MACRO 


[label:] 

where: label 


.MACRO name, dummy argument list 
represents an optional statement label. 


name 


represents the user-assigned symbolic name of the 
macro. This name may be any legal symbol and may 
be used as a label elsewhere in the program. 

represents any legal separator (comma, space, 
and/or tab). 


I 
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dummy represents a number of legal symbols (see Section 

argument 3.2.2) that may appear anywhere in the body of the 
list macro definition, even as a label. These dummy 

symbols can be used elsewhere in the program with 
no conflict of definition. Multiple dummy 
arguments specified in this directive may be 
separated by any legal separator. The detection 
of a duplicate or an illegal symbol in a dummy 
argument list terminates the scan and causes an 
error code (A) to be generated. 


A comment may follow the dummy argument list in a .MACRO directive, as 
shown below: 


.MACRO ABS A,B 


The first statement of a macro 


;Defines macro ABS with two arguments, 
definition must be a .MACRO directive. 


NOTE 

Although it is legal for a label to 
appear on a .MACRO directive, this 
practice is discouraged, especially in 
the case of nested macro definitions, 
because invalid labels or labels 
constructed with the concatenation 
character will cause the macro directive 
to be ignored. This may result in 
improper termination of the macro 
definition. 

This NOTE also applies to .IRP, .IRPC, 
and .REPT. 





7.1.2 .ENDM Directive 

Format: 


.ENDM 


.ENDM [name] 


where: name represents an optional argument specifying the 

name of the macro being terminated by the 
directive. 


Example: 


.ENDM 

.ENDM ABS 


^•Terminates the current 
;macro definition. 

^•Terminates the current 
;macro definition named ABS. 




I 
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iame Pe sDfi?M e d h !n m ^I 0 . name in ‘ ENDM statement must match the 

name specified m the corresponding .MACRO directive. Otherwise the 

statement 1. flagged with an error code (A) in the assembly HsuSg? 

SpecifiiJo th.'Slac' current macro definition is terminated. 

In Si h '• ^ r ° name ln the * ENDM statement thus permits MACRO-11 

definitions miSSlng ,ENDM statements or improperly nested macro 


The .ENDM directive must not have a label. if a 
attached, it will be ignored. if an illegal label 
directive will be ignored. 


legal label is 
is attached, the 


The .ENDM directive may be followed by a comment 
below: 


field, 


as shown 


•MACRO TYPMSG MESSGE ;Type a message. 

JSR R5,TYPMSG 

.WORD MESSGE 

• ENDM ;End of TYPMSG macro. 


The final statement of every macro definition must be an .ENDM 
directive. The .ENDM directive is also used to terminate indefinite 

blocks (see lecUon ” ay ** t0 ter,1 "» te 





7.1.3 .MEXIT Directive 
Fo rmat: 


■ MEXIT 


.MEXIT 


The .MEXIT directive may be used to terminate a macro expansion before 
the end of the macro is encountered. This directive is also leqal 
within repeat blocks (see Sections 7.6 and 7.7). It is most useful in 
nested macros. The .MEXIT directive terminates the current macro as 
though an .ENDM directive had been encountered. Using the .MEXIT 
directive bypasses the complexities of nested conditional directives 
and alternate assembly paths, as shown in the following example: 

.MACRO ALTR N,A,B 


,IF EQ N 


;Start conditional assembly block. 


•MEXIT 
. ENDC 


;Terminate macro expansion. 

;End conditional assembly block. 


• ENDM ;Normal end of macro. 

In an assembly where the dummy symbol N is replaced by zero (see Table 
6-6), the .MEXIT directive would assemble the conditional block and 
terminate the macro expansion. When macros are nested, a MEXIT 
directive causes an exit to the next higher level of macro expansion. 


I 
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A .MEXIT directive encountered outside a macro definition is flagged 
with an error code (0) in the assembly listing. 


7.1.4 MACRO Definition Formatting 

A form-feed character used within a macro definition causes a page 
eject during the assembly of the macro definition. A page eject, 
however, is not performed when the macro is expanded. 

Conversely, when the .PAGE directive is used in a macro definition, it 
is ignored during the assembly of the macro definition, but a page 
eject is performed when that macro is expanded. 


7.2 CALLING MACROS 


Format: 

[label:] name real arguments 
where: label represents an optional statement label. 


name 


real 

arguments 


represents the name of the macro, as specified in 
the .MACRO directive (see Section 7.1.1). 

represent symbolic arguments which replace the 
dummy arguments listed in the .MACRO directive. 
When multiple arguments occur, they are separated 
by any legal separator. Arguments to the macro 
call are treated as character strings, their usage 
is determined by the macro definition. 

A macro definition must be established by means of the .MACRO 
directive (see Section 7.1.1) before the macro can be called and 
expanded within the source program. 

When a macro name is the same as a user label, the appearance of the 
symbol in the operator field designates the symbol as a macro call; 
the appearance of the symbol in the operand field designates it as a 
label, as shown below: 


ABS: 


MOV 


(R0),R1 


;ABS is defined as a label. 


BR 


ABS 


;ABS is considered to be a label, 


ABS #4,ENT,LAR 


;ABS is a macro call. 


7.3 ARGUMENTS IN MACRO DEFINITIONS AND MACRO CALLS 

Multiple arguments within a macro definition or macro call must be 
separated by one of the legal separating characters described in 
Section 3.1.1. 
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Macro definition arguments (dummy) and macro call arquments (real} 
normally maintain a strict positional relationship? ?Kt is the 
fJonm r ® al , ar gument in a macro call corresponds with the first dummy 

a macro can ^ maCr ° Only the use of keyword arguments in 
a macro call can override this correspondence (see Section 736) 


For example, the following macro definition and its 
call contain multiple arguments: 


associated macro 


•MACRO REN A,B,C 


REN ALPHA,BETA,<C1,C2> 

Arguments which themselves contain separating characters must be 
enclosed in paired angle brackets. For example, the macro call: 

REN <MOV X,Y>,#44,WEV 

causes the entire expression 


MOV X, Y 

to replace all occurrences of the symbol A in the macro definition. 
Real arguments within a macro call are considered to be character 
strings and are treated as a single entity during the macro expansion. 

The up-arrow ( ) construction allows angle brackets to be passed as 
part of the argument. This construction, for example, could have been 
used in the above macro call, as follows: 

REN ~/<MOV X,Y>/,#44,WEV 

causing the entire character string <MOV X,Y> to be passed as an 
argument. 


Because of the use of the up-arrow (~) shown above, care must be taken 
when^ passing an argument beginning with a unary operator (~0, ~D f ~B, 
~R, ~F ...). These arguments must be enclosed in angle brackets' (as 
shown below) or MACRO-11 will read the character following the 
up-arrow as a delimiter. 

REN <~0 411>,X,Y 
The following macro call: 


REN #44,WEV~/MOV X,Y/ 


contains only two arguments (#44 and 
up-arrow is a unary operator (see 
preceded by an argument separator. 


WEV~/MOV X,Y/) 
Section 3.1.3) 


because the 
and it is not 


As shown 
argument 


in the examples above, spaces can be used within bracketed 
constructions to increase the legibility of such expressions. 
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7.3.1 Macro Nesting 

Macro nesting occurs where the expansion of one macro includes a call 
to another. The depth of nesting allowed depends upon the amount of 
dynamic memory used by the source program being assembled. 

To pass an argument containing legal argument delimiters to nested 
macros, enclose the argument in the macro definition within angle 
brackets, as shown in the coding sequence below. This extra set of 
angle brackets for each level of nesting is required in the macro 
definition, not in the macro call. 


.MACRO 

LEVEL1 

DUM1,DUM2 

LEVEL2 

<DUM1> 


LEVEL2 
. ENDM 

<DUM2> 


.MACRO 

DUM3 

LEVEL2 

DUM3 

ADD 

#10,40 


MOV 

.ENDM 

R0,(Rl)+ 


A call to the LEVELI macro, as shown below, for example: 

LEVELI <MOV X,R0>,<MOV R2,R0> 
causes the following macro expansion to occur: 


MOV 

X, R0 

ADD 

#10,R0 

MOV 

R0 , (Rl) + 

MOV 

R2,R0 

ADD 

#10,R0 

MOV 

R0,(Rl)+ 


When macro definitions are nested, the inner definition cannot be 
called until the outer macro has been called and expanded. For 
example, in the following coding: 

.MACRO LV1 A,B 


.MACRO LV2 C 


. ENDM 
. ENDM 

the LV2 macro cannot be called and expanded until the LV1 macro has 
been expanded. Likewise, any macro defined within the LV2 macro 
definition cannot be called and expanded until LV2 has also been 
expanded. 


J 

4 


•I 

I 

I 

I 
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7.3.2 Special Characters in Macro Arguments 

If an argument does not contain spaces, tabs, semicolons, or commas it 
may include special characters without enclosing them in a bracketed 
construction. For example: 

.MACRO PUSH ARG 
MOV ARG,-(S P) 

. ENDM 


PUSH X+3(%2) 

causes the following code to be generated: 
MOV X+3(%2),-(SP) 


7.3.3 Passing Numeric Arguments as Symbols 


If the unary operator backslash (\) precedes an argument, the macro 
treats that argument as a numeric value in the current program radix. 
The ASCII characters representing this value are inserted in the macro 
expansion, and their function is defined in the context of the 
resulting code, as shown in the following example: 


.MACRO INC A,B 
CON A ,\B 

B=B+1 

. ENDM 

.MACRO CON A,B 
A' B: .WORD 4 

.ENDM 


;B is treated as a number in current 
;program radix. 

;A 1 B is described in Section 7.3.7. 


C=0 INC X,C 

The above macro call (INC) would thus expand to: 
X0: .WORD 4 


In this expanded code, the label X0: results from the concatenation 
of two real arguments. The single quote (') character in the label 
A'B: concatenates the real arguments X and 0 as they are passed 
during the expansion of the macro. This type of argument construction 
is described in more detail in Section 7.3.7. 

A subsequent call to the same macro would generate the following code: 
XI: .WORD 4 


and so on, for later calls. The two macro definitions are necessary 
because the symbol associated with dummy argument B (that is, C) 
cannot be updated in the CON macro definition, because the character 0 
has replaced C in the argument string (INC X, C). In the CON macro 
definition, the number passed is treated as a string argument. (Where 
the value of the real argument is 0, only a single 0 character is 
passed to the macro expansion.) 
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Passing numeric values in this manner is useful in identifying source 
listings. For example, versions of programs created through 
conditional assemblies of a single source program can be identified 
through such coding as that shown below. Assume, for example, that 
the symbol ID in the macro call (IDT) has been equated elsewhere in 
the source program to the value 6. 

.MACRO IDT SYM ;Assume that the symbol ID takes 

.IDENT /V01• 1 SYM/ ;on a unique 2-digit value. 

.ENDM ;Where V01 is the update 

. ;version of the program. 



IDT \ID 

The above macro call would then expand to: 
.IDENT /V01.6/ 

where 6 is the numeric value of the symbol ID. 



7.3.4 Number of Arguments in Macro Calls 


A macro can be defined with or without arguments. If more arguments 
appear in the macro call than in the macro definition, an error code 
(Q) is generated in the assembly listing. If fewer arguments appear 
in the macro call than in the macro definition, missing arguments are 
assumed to be null values. The conditional directives .IF B and .IF 
NB (see Table 6-6) can be used within the macro to detect missing 
arguments. The number of arguments can also be determined using the 
.NARG directive (Section 7.4.1). 



7.3.5 Creating Local Symbols Automatically 

A label is often required in an expanded macro. In the conventional 
macro facilities thus far described, a label must be explicitly 
specified as an argument with each macro call. The user must be 
careful in issuing subsequent calls to the same macro in order to 
avoid duplicating labels. This concern can be eliminated through a 
feature of MACRO-11 that creates a unique symbol where a label is 
required in an expanded macro. 

As noted in Section 3.5, MACRO-11 can automatically create local 
symbols of the form n$, where n is a decimal integer within the range 
30000 through 65535, inclusive. Such local symbols are created by 
MACRO-11 in numerical order, as shown below: 

30000$ 

30001$ 



65534$ 

65535$ 
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This automatic generation is invoked on each call of a macro whose 
definition contains a dummy argument preceded by the question mark (?) 
character, as shown in the macro definition below: 


B: 


.MACRO ALPHA, A,?B 

TST A 

BEQ B 

ADD #5,A 

. ENDM 


;Contains dummy argument B preceded by 
/question mark. 


A local symbol is created automatically by MACRO-11 only when a real 
argument of the macro call is either null or missing, as shown in 
Example 1 below. If the real argument is specified in the macro call, 
however, MACRO-11 inhibits the generation of a local symbol and normal 
argument replacement occurs, as shown in Example 2 below. (Examples 1 
and 2 are both expansions of the Alpha macro defined above.) 

EXAMPLE Is Create a Local Symbol for the Missing Argument: 


30000$: 

EXAMPLE 


XYZ : 


ALPHA 

TST 

R1 

R1 

/Second 

argument 

BEQ 

ADD 

30000$ 

#5 ,R1 

/Local 

symbol is 

2: Do 

Not Create 

a Local Symbol: 

ALPHA 

TST 

R2,XYZ 

R2 

/ Second 

argument 

BEQ 

ADD 

XYZ 
#5 , R2 

/Normal 

argument 


is missing, 
created. 


XYZ is specified, 
replacement occurs. 


Automatically created local symbols are restricted to the first 16(10) 
arguments of a macro definition. 

Automatically created local symbols resulting from the expansion of a 
macro, as described above, do not establish a local symbol block in 
their own right. 

When a macro has several arguments earmarked for automatic local 
symbol generation, substituting a specific label for one such argument 
risks assembly errors because MACRO-11 constructs its argument 
substitution list at the point of macro invocation. Therefore, the 
appearance of a label, the .ENABL LSB directive, or the .PSECT 
directive, in the macro expansion will create a new local symbol 
block. The new local symbol block could leave local symbol references 
in the previous block and their symbol definitions in the new one, 
causing error codes in the assembly listing. Furthermore, a later 
macro expansion that creates local symbols in the new block may 
duplicate one of the symbols in question, causing an additional error 
code (P) in the assembly listing. 
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7.3.6 Keyword Arguments 
Format: 


name=string 


where: 


name 


string 


represents the dummy argument, 
represents the real symbolic argument, 


The keyword argument may not contain embedded argument 
unless delimited as described in Section 7.3. 


separators 


Macros may be defined with, and/or called with, keyword arguments. 
When a keyword argument appears in the dummy argument list of a macro 
definition, the specified string becomes the default real argument at 
macro call. When a keyword argument appears in the real argument list 
of a macro call, however, the specified string becomes the real 
argument for the dummy argument that matches the specified name, 
whether or not the dummy argument was defined with a keyword. If a 
match fails, the entire argument specification is treated as the next 
positional real argument. 

A keyword argument may be specified anywhere in the dummy argument 
list of a macro definition and is part of the positional ordering of 
argument. A keyword argument may also be specified anywhere in the 
real argument list of a macro call but, in this case, does not affect 
the positional ordering of the arguments. 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 


.LIST 


ME 


Define a macro having keywords in dummy argument 
list 

.MACRO TEST C0NTRL=1,BLOCK,ADDRES=TEMP 
.WORD CONTRL 
.WORD BLOCK 
.WORD ADDRES 
. ENDM 


Now invoke several times 


17 

000000 


TEST 

A , B , C 


000000 

000000G 

.WORD 

A 


000002 

000000G 

.WORD 

B 


000004 

0 00 00 0G 

.WORD 

C 

18 

19 

000006 


TEST 

ADDRES=20,BLOCK=30,CONTRL=40 


000006 

000040 

.WORD 

40 


000010 

000030 

.WORD 

30 


000012 

000020 

.WORD 

20 

20 

21 

000014 


TEST 

BL0CK=5 


000014 

000001 

.WORD 

1 


000016 

000005 

.WORD 

5 


000020 

000000G 

.WORD 

TEMP 


■ 


j 


j 



% 




■ 
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22 


23 

000022 


TEST 


000022 

000005 

.WORD 


000024 

000000 

.WORD 


000026 

000000G 

.WORD 

24 

25 

000030 


TEST 


000030 

000001 

.WORD 


000032 

000000 

.WORD 


000034 

000000G 

.WORD 

26 

27 

000036 


TEST 


000036 

000001 

.WORD 


000040 

000000 

.WORD 


000042 

000000C 

.WORD 

28 

29 

30 


000001 

. END 


CONTRL=5,ADDRES=VARIAB 
5 

VARIAB 

1 

TEMP 

ADDRES=JACK!JILL 
1 

JACKiJILL 


7.3.7 Concatenation of Macro Arguments 

The apostrophe or single quote character (') operates as a legal 
delimiting character in macro definitions. A single quote that 
precedes and/or follows a dummy argument in a macro definition is 
removed, and the substitution of the real argument occurs at that 
point. For example, in the following statements: 

.MACRO DEF A,B,C, 

A'B: .ASCIZ /C/ 

.BYTE ''A,''B 

. ENDM 


when the macro DEF is called through the statement: 


DEF X,Y,<MACRO-11> 

it is expanded, as follows: 


XY: .ASCIZ /MACRO-11/ 

•BYTE 'X,'Y 

In expanding the first line, the scan for the first argument 
terminates upon finding the first apostrophe (') character. Since A 
is a dummy argument, the apostrophe (') is removed. The scan then 
resumes with B; B is also noted as another dummy argument. The two 
real arguments X and Y are then concatenated to form the label XY:• 
The third dummy argument is noted in the operand field of the .ASCIZ 
directive, causing the real argument MACRO-11 to be substituted in 
this field. 
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When evaluating the arguments of the .BYTE directive during expansion 
of the second line, the scan begins with the first apostrophe ( ) 
character. Since it is neither preceded nor followed by a dummy 
argument, this apostrophe remains in the macro expansion. The scan 
then encounters the second apostrophe, which is followed by a dummy 
argument and is therefore discarded. The scan of argument A is 
terminated upon encountering the comma (,). The third apostrophe is 
neither preceded nor followed by a dummy argument and again remains in 
the macro expansion. The fourth (and last) apostrophe is followed by 
another dummy argument and is likewise discarded. (Four apostrophe 
(') characters were necessary in the macro definition to generate two 
apostrophe (') characters in the macro expansion.) 



7.4 MACRO ATTRIBUTE DIRECTIVES: .NARG, .NCHR, AND .NTYPE 

MACRO-11 has three directives that allow the user to determine certain 
attributes of macro arguments: .NARG, .NCHR, and .NTYPE. The use of 
these directives permits selective modifications of a macro expansion, 
depending on the nature of the arguments being passed. These 
directives are described below. 



7.4.1 .NARG Directive 


.NARG 


Format: 


[label:] .NARG symbol 


where: label 


represents an optional 


statement label. 


symbol represents any legal symbol. This symbol is 
equated to the number of non-keyword arguments in 
the macro call currently being expanded. If a 
symbol is not specified, the .NARG directive is 
flagged with an error code (A) in the assembly 
1 isting. 


The .NARG directive 
arguments in the 
.NARG directive can 
appears elsewhere, 
1 i s t i ng . 


is used to determine the number of non—keyword 
macro call currently being expanded. Hence, the 
appear only within a macro definition; if it 
an error code (0) is generated in the assembly 


An example of the 


.NARG directive is shown in Figure 7-1. 
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1 .TITLE NARG 

2 

3 •ENABL LC 

4 .LIST ~ME 

5 * + 

6 i Example of the .NARG directive 

7 

8 

9 .MACRO NULL NUM 


10 

11 

12 

13 

14 

15 

16 

17 

18 .ENOM 

19 

20 000000 

000000 


21 

22 000000 

000001 



000006 

000000 

000240 

000002 

000240 

000004 

000240 

000006 

000240 

000010 

000240 

000012 

000240 


000001 


Figure 7-1 Exampl 


.NARG SYM 
.IF EQ SYM 
♦MEXIT 
.IFF 

♦REFT NUM 
NOP 
»ENDM 
. ENDC 


NULL 

.NARG SYM 
.IF EQ SYM 
.MEXIT 

♦ IFF 
.REPT 
NOP 
.ENDM 
.ENDC 

NULL 6 
♦NARG SYM 
♦IF EQ SYM 
.MEXIT 

♦ IFF 

♦REPT 6 

NOP 

.ENDM 

NOP 

NOP 

NOP 

NOP 

NOP 

NOP 

.ENDC 

.END 


of .NARG Directive 


7.4.2 .NCHR Directive 


.NCHR 


Format: 

[label:] 

where: label 

symbol 


.NCHR symbol,<string> 

represents an optional statement label. 


This 


represents any legal symbol, 
equated to the number of characters 
specified character string. If a symbol 
specified, the .NCHR directive is flagged 
error code (A) in the assembly listing. 


symbol 
in 


is 
the 
is not 
with an 


represents any legal separator (comma, space, 
and/or tab). 


7-13 











MACRO DIRECTIVES 


I 


<string> represents a string of printable characters. If 
the character string contains a legal separator 
(comma, space, and/or tab) the whole string must 
be enclosed within angle brackets (<>) or 

up-arrows ("). If the delimiting characters do 
not match or if the ending delimiter cannot be 
detected because of a syntactical error in the 
character string (thus prematurely terminating its 
evaluation), the .NCHR directive is flagged with 
an error code (A) in the assembly listing. 

The .NCHR directive, which can appear anywhere in a MACRO-11 program, 
is used to determine the number of characters in a specified character 
string. This directive is useful in calculating the length of macro 
arguments. 

An example of the .NCHR directive is shown in Figure 7-2. 


♦TITLE NCHR 

♦ENABL LC 
•LIST ME 

; Illustrate the .NCHR directive 


7 *- 

8 

9 ♦ MACRO 

10 

11 

12 

13 

14 .ENDM 

15 

16 000000 msgi: 

000005 
000000 000005 

000002 110 
000003 145 

000004 154 

000005 154 

000006 157 

17 

18 000001 


Figure 7-2 Example 


STRING 

♦ NCHR 

♦ WORD 
♦ASCII 

♦ EVEN 

MESSAG 
♦ $$ r MESSAG 

%%% 

/MESSAG/ 

STRING 

♦ NCHR 

• WORD 
♦ASCII 

<Hello> 
$$$,Hello 
%%% 

/Hello/ 

♦ EVEN 


• END 



of .NCHR Directive 


«p 



7.4.3 .NTYPE Directive 


.NTYPE 


Fo rmat: 

[label:] 

where: label 

symbol 


.NTYPE symbol,aexp 

represents an optional statement label. 

represents any legal symbol. This symbol is 
equated to the 6-bit addressing mode of the 
following expression (aexp). If a symbol is not 
specified, the .NTYPE directive is flagged with an 
error code (A) in the assembly listing. 
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I 

I 

I 

I 

<0 

I 

I 

10 

I 

I 

fi 

I 

I 

I 

1 * 

I 


represents any legal separator (comma, 
and/or tab). 


space, 


aex P represents any legal address expression, as used 

with an opcode. If no argument is specified, an 
error code (A) will appear in the assembly 
listing. 


The .NTYPE directive is used to determine the addressing mode of a 

.NTYPE direct 
*rs elsewher 
sembly listing, 

An example of the use of an .NTYPE directive in a macro definition is 
shown in Figure 7-3. 


ine .NiYfh airective is used to determine the addressing mode of a 
specified macro argument. Hence, the .NTYPE directive can appear only 
within a macro definition; if it appears elsewhere, it is flaqqed 
with an error code (0) in the assembly listing. 


.TITLE NTYPE 

♦ENABL LC 
♦LIST HE 




7 


t Illustrate the .NTYPE dir 

8 


i- 



9 





10 


. MACRO 

SAVE 

ARC 

11 



♦NTYPE 

♦♦♦'ARG 

12 


♦ IF EQ 

♦♦♦170 


13 



MOV 

ARG'-(SP) 

14 



♦ IFF 


15 



MOV 

♦ARG'-(SP) 

16 


♦ ENDC 



17 


♦ ENDH 



18 





19 000000 



SAVE 

R1 


000001 


♦NTYPE 

♦♦♦'Rl 



♦ IF EQ 

♦♦♦170 


000000 

010146 


MOV 

R1»-(SP) 




♦ IFF 





MOV 

♦Rl'-(SP) 



♦ ENDC 



20 





21 000002 



SAVE 

TEMP 


000067 


♦NTYPE 

♦♦♦'TEMP 



♦ IF EQ 

♦♦♦170 





MOV 

TEMP»-(SP) 




♦ IFF 


000002 

012746 


MOV 

♦TEMP'-(SP) 


000006 ' 






♦ ENDC 



22 





23 000006 

000000 

temp: 

• WORD 

0 

24 





25 

000001 


♦ END 


Figure 7 

-3 Example 

of .NTYPE Direct 


'Save in register node 
?Save in non-register aode 


'Save in register *ode 
»Save in non-register *ode 


'Save in register aode 
'Save in non-register aode 


For additional information concerning addressing modes, refer to 
Chapter 5 and Appendix B.2. 
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7.5 .ERROR AND .PRINT DIRECTIVES 
Format: 


[■ERROR | 


[label:] 

where: label 

expr 


text 


.ERROR [expr] ;text 

represents an optional statement label. 

represents an optional expression whose value is 
output when the .ERROR directive is encountered 
during assembly. 

denotes the beginning of the text string. 

represents the message associated with the .ERROR 
directive. 

The .ERROR directive is used to output messages to the listing fil® 
durina assembly pass 2. A common use of this directive is to alert 
the user to a rejected or erroneous macro call or to the existence o 
an illegal set of conditions in a conditional assembly. If the 
listing file is not specified, the .ERROR messages are output to the 
command output device. 

Upon encountering an .ERROR directive anywhere in a source program, 
MACRO-11 outputs a single line containing: 

1. An error code (P) 

2. The sequence number of the .ERROR directive statement 

3. The value of the current location counter 

4. The value of the expression, if one is specified 

5. The source line containing the .ERROR directive. 

For example, the following directive: 

.ERROR A ;Invalid macro argument 
causes a line in the following form to be output to the listing file: 


Seq. 

Loc. 

Exp. 


Text 

No. 

No. 

Value 


512 

005642 

000076 

.ERROR A 

;Invalid macro argument 


I 


J 


J 



•I 



I 
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*0 

, |-PRINT | 


The .PRINT directive is identical in function to the .ERROR directive, 
except that it is not flagged with the error code (P). 



7.6 INDEFINITE REPEAT BLOCK DIRECTIVES: .IRP AND .IRPC 

An indefinite repeat block is similar to a macro definition with only 
one dummy argument. At each expansion of the indefinite repeat range, 
this dummy argument is replaced with successive elements of a real 
argument list. Since the repeat directive and its associated range 
are coded in-line within the source program, this type of macro 
definition and expansion does not require calling the macro by name, 
as required in the expansion of the conventional macros previously 
described in this chapter. 

An indefinite repeat block can appear either within or outside another 
macro definition, indefinite repeat block, or repeat block. The rules 
for specifying indefinite repeat block arguments are the same as for 
specifying macro arguments (see Section 7.3). 



7.6.1 


.IRP Directive 



Format: 

[label:] .IRP sym,<argument list> 


I* 


(range of indefinite repeat block) 


. ENDM 

where: label 


represents an optional statement label. 


NOTE 

Although it is legal for a label to appear 
on a .MACRO directive, this practice is 
discouraged, especially in the case of 
nested macro definitions, because invalid 
labels or labels constructed with the 
concatenation character will cause the 
macro directive to be ignored. This may 
result in improper termination of the 
macro definition. 

This NOTE also applies to .IRPC and .REPT. 


I 
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represents a dummy argument that is replaced with 
successive real arguments from within the angle 
brackets. If no dummy argument is specified, the 
.IRP directive is flagged with an error code (A) 
in the assembly listing. 


, represents any legal separator (comma, space, 

and/or tab). 

<argument list> represents a list of real arguments enclosed 

within angle brackets that is to be used in the 
expansion of the indefinite repeat range. A real 
argument may consist of one or more characters; 
multiple arguments must be separated by any legal 
separator (comma, space, and/or tab). If no real 
arguments are specified, no action is taken. 


range represents the block of code to be repeated once 

for each occurrence of a real argument in the 
list. The range may contain other macro 

definitions, repeat ranges and/or the .MEXIT 
directive (see Section 7.1.3). 

.ENDM indicates the end of the indefinite repeat block 

range. 

The .IRP directive is used to replace a dummy argument with successive 
real arguments specified in an argument string. This replacement 
process occurs during the expansion of an indefinite repeat block 
range. 

An example of the use of the .IRP directive is shown in Figure 7-4. 


j 



7.6.2 .IRPC Directive 

Format: 

[label:] .IRPC sym,<string> 

(range of indefinite repeat block) 


■ IRPC | 



. ENDM 

where: label 

sym 


represents an optional statement label (see Note 
in Section 7.6.1) . 


represents a dummy argument that is replaced with 
successive real arguments from within the angle 
brackets. If no dummy argument is specified, the 
.IRPC directive is flagged with an error code (A) 
in the assembly listing. 



I 
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I 

I 

I 

b 

i 

i 



i 

i 

i 

i 

i 



i 


represents any legal separator (comma, 
and/or tab). 


space, 


<string> 


range 


represents a list of characters, enclosed within 
angle brackets, to be used in the expansion of the 
indefinite repeat range. Although the angle 
brackets are required only when the string 
contains separating characters, their use is 
recommended for legibility. 

represents the block of code to be repeated once 
for each occurrence of a character in the list. 
The range may contain macro definitions, repeat 
ranges and/or the .MEXIT directive (see Section 
7.1.3) • 


, ENDM 


indicates the end of the indefinite 
range. 


repeat block 


The .IRPC directive is available to permit single character 
substitution, rather than argument substitution. On each iteration of 
the indefinite repeat range, the dummy argument is replaced with 
successive characters in the specified string. 

An example of the use of the .IRPC directive is shown in Figure 7-4. 


.TITLE IRPTST 


.LIST 


ME 


9 Illustrate the .IRP and .IRPC directives 
9 by creating a pair of RAD50 tables 
9- 


9 

000000 


regs: 

.IRP 

REG»<PCrSPrR5rR4rR3rR2rRlrR0> 

10 




• RAD50 

/REG/ 

11 




.ENDR 



000000 

062170 


•RAD50 

/PC/ 


000002 

074500 


♦RAD50 

/SP/ 


000004 

072770 


•RAD50 

/R5/ 


000006 

072720 


♦ RAD50 

/R4/ 


000010 

072650 


.RAD50 

/R3/ 


000012 

072600 


•RAD50 

/R2/ 


000014 

072530 


»RAD50 

/Rl/ 


000016 

072460 


•RAD50 

/R0/ 

12 






13 

000020 


REGS2: 

.IRPC 

NUM 9 <76543210> 

14 




•RAD50 

/R'NUM/ 

15 




• ENDR 



000020 

073110 


•RAD50 

/R7/ 


000022 

073040 


•RAD50 

/R6/ 


000024 

072770 


. RAD50 

/R5/ 


000026 

072720 


•RAD50 

/R4/ 


000030 

072650 


.RAD50 

/R3/ 


000032 

072600 


•RAD50 

/R2/ 


000034 

072530 


•RAD50 

/Rl/ 


000036 

072460 


•RAD50 

/R0/ 

16 






17 


000001 


• END 



Figure 7-4 Example of .IRP and .IRPC Directives 
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Crept 

I.endr 

7.7 REPEAT BLOCK DIRECTIVE: .REPT, .ENDR - -- 

Format: 

[label:] .REPT exp 


(range of 


repeat block) 


.ENDR 

where: label 


exp 


range 


. ENDM 
or 

.ENDR 


represents an optional statement label (see Note 
in Section 7.6.1). 

represents any legal expression. This value 
controls the number of times the block of code is 
to be assembled within the program. When the 
expression value is less than or equal to zero 
(0), the repeat block is not assembled. If this 
expression is not an absolute value, the .REPT 
statement is flagged with an error code (A) in the 
assembly listing. 

represents the block of code to be repeated. The 
repeat block may contain macro definitions, 
indefinite repeat blocks, other repeat blocks 
and/or the .MEXIT directive (see Section 7.1.3). 

indicates the end of the repeat block range. 


The .REPT directive is used to duplicate a block of code, a certain 
number of times, in line with other source code. 


I .MCALL I 

7.8 MACRO LIBRARY DIRECTIVE: .MCALL I 

Format: 

.MCALL a rgl,a rg2,...argn 

represent the symbolic names of the macro 
definitions required in the assembly of the source 
program. The names must be separated by any legal 
separator (comma, space, and/or tab). 


where: argl, 

arg2 , . . . 
a rgn 
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and/or^ntiar-^f' iV ^ allows you to indicate in advance those system 
/or user defined macro definitions that are not defined within the 
2“5°f Program but which are required to assemble the program. The 

.MCALL directive must appear before the first occurrence of a call to 
any externally defined macro: unence or a can to 

• Auto-Mcall mode is disabled (the default) 

or 

* IwmK n ? me of ,^ he m ? cro being called is one of MACRO'S permanent 
symbols or directives, such as SUB, .ERROR, or .PRINT. 

Swi ^ ch ( ! ee Section 8.1.3) under RSX-11M and the /LIBRARY 
qualifier (see Section 8.2.2) under IAS and RT-11, used with an input 
file specification, indicate to MACRO-11 that the file is a macro 
i r , Ad ^ tlonal macro libraries to be searched may also be 

pecified m the MACRO-11 program itself, using the MACRO-11 .LIBRARY 

who! a S " ti0n f; 1 ?- 1 £or a of tie :“bS 

MArnn-n fi Wh ! macro call is encountered in the source program, 

definition* S ^ rches the user macro library for the named macro 

macJo library d ' lf necessar y' continues the search with the system 

Any number of such user-supplied macro files may be designated. For 

ll ^ ra ^ flles ' the search for the named macros begins with 

until ^ UCh flle S r Cifi6d - The fileS are searc hed in reve?se order 
until the required macro definitions are found. finishing if 

necessary, with a search of the system macro library. ' 

l irt^ na T e f maCr ° * S n0t found upon completion of the search, the 

state "’® nt 1S flagged with an error code (U) in the assembly 

isting Furthermore, a statement elsewhere in the source program 

at a 6m ?^f - t0 u expand such an undefined macro is flagged with an 
error code (0) in the assembly listing. 


The command strings to MACRO-11, through which file specificati 
S ar ? d ff cr i bed in detail in the applicable system manu 


Section 0.3 in the Preface). 


:ions are 
lual (see 


7.9 MACRO DELETION DIRECTIVE: .MDELETE 
Format: 

•MDELETE namel,name2,...,namen 


-MDELETE 


where: namel, 

name2, 
namen 


represent legal macro names. When multiple 
names are specified, they are separated by 
any legal separator (comma, space, and/or tab). 


The .MDELETE directive deletes the definitions of the specified 

“' ro(s) ' fre ® ln g virtual memory. If references are made to deleted 
macros, the referencing line is flagged with an opcode (0) error. 

An example of the .MDELETE directive is shown below. 

•MDELETE .EXIT,EXIT$S 


I 
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IAS/RSX-11M/RSX-11M-PLUS OPERATING PROCEDURES 




MACRO-11 assembles one or more ASCII source files containing MACRO-11 
statements into a single relocatable binary object file. This binary 
object file contains the table of contents listing, the assembly 
listing, and the symbol table listing. An optional cross-reference 
listing of symbols and macros is available. A sample assembly listing 
is provided in Appendix H. 


8.1 RSX—11M/RSX—11M-PLUS OPERATING PROCEDURES 

On RSX-11M and RSX-11M-PLUS systems, two command languages are 
available: the Monitor Console Routine (MCR) and the DIGITAL Command 
Language (DCL). When you log onto the system, you are given either 
MCR or DCL as the default command language. Your default command 
language is contained in your account file. 

By typing CTRL/C (~C) from the monitor prompt, you can see the 
explicit prompt for the command language you are currently using. 

> ~C 
MCR> 

> ~C 
DC L> 

You can switch from one command language to the other. To switch from 
DCL to MCR, type the following command: 

DCL> SET TERMINAL MCR 

To switch from MCR to DCL, type the following command: 

MCR> SET /DCL=TI: 

In addition to switching from one command language to the other, you 
can type a DCL command from a terminal set to MCR, and an MCR command 
from a terminal set to DCL, as shown below: 

MCR> DCL cmd-string 

DCL> MCR cmd-string 
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8.1.1 Initiating MACRO-11 Under RSX-11M/RSX-11M-PLUS 

The following sections describe those MACRO-11 operating procedures 
that apply to both the Monitor Console Routine and the DIGITAL Command 
Language. Any one of the four methods shown below may be employed to 
initiate MACRO-11. 



8. 1.1.1 Method 1 - Direct MACRO-11 Call 
MCR Format: 

MCR>MAC 

MAOcmd-string 

The Monitor Console Routine (MCR) accepts MAC as input, causing 
MACRO-11 to be activated. Since a command string is not present with 
the MCR line, MACRO-11 then solicits input with the prompting sequence 
MAC> and waits for command string input. After the assembly of the 
indicated files has been completed, MACRO-11 again solicits command 
string input with the MAO prompting sequence. This process will be 
repeated until CTRL/Z (~Z) is entered. 

DCL Format: 

DCL> MACRO[/qual ifier( s) ] 

File(s)? filespec[/qualifiers]... 

DCL accepts MACRO as input. In addition, you may include the 
qualifiers contained in Table 8-3. Since no file specifications are 
included in the DCL command line, MACRO-11 solicits input with the 
File(s) prompt. You can then enter the name of one or more source 
files plus any of the qualifiers listed in Table 8-4. When you press 
RETURN, MACRO-11 performs the assembly. 




8.1.1.2 Method 2 - Single Assembly 
MCR Format: 

MCR>MAC cmd-string 
DCL Format: 

DCL> MACRO cmd-string 

In method 2, no prompting from MACRO-11 occurs, since the command 
string input is included in the command line. MACRO-11 then assembles 
the source files in the command string and exits when finished. 

8.1.1.3 Method 3 - Install, Run Immediately, and Remove On Exit 


Format: 

>RUN $MAC 
MAOcmd-string 
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This method is used when the MACRO-11 assembler is not permanently 
installed in the system. On RSX-11M, the system must be generated for 
this type of call support. MAC is run from the system directory. 
MACRO-11 solicits command string input. The command string must have 
the.MCR format even if run from a DCL terminal. When MACRO-11 exits, 
it is automatically removed from the system. 

If the system has the "flying install" feature, the RUN $ calling 
format is not needed. 


8.1.1.4 Method 4 - Using the Indirect Command Processor 

MCR Formats: 

MCR>MAC 
MAO @f ilespec 

or 

MCR>MAC @filespec 
or 

MAORUN $MAC[/UIC=[g,m] ] 

MAO @f ilespec 

These forms use the indirect command processor, which effectively 
accomplishes the substitution of "@filespec" for the "cmd-string" 
input employed in methods 1 through 3. In these formats, the indirect 
command processor is passing commands to the assembler. The file 
specified as "@filespec" contains MACRO-11 command strings. After 
this file is opened, command lines are read from the file until the 
end-of-file is detected. Three nested levels of indirect files are 
permitted in MACRO-11. 

MCR and DCL Format: 

DCL> @filespec 

These forms use the indirect command processor to pass commands to the 
command language. This is the only form you can use with DCL. The 
indirect command file "@filespec" must contain one of the command 
lines to initiate MACRO-11 as listed in methods 1 through 3. 


NOTE 

MACRO-11 can be terminated by entering a 
CTRL/Z (~Z) at any time a request for 
command string input is present. 


8.1.2 Default File Specifications 

MACRO-11 accepts as input or creates as output up to six types of 
files. When using the MACRO-11 assembler, you should keep in mind the 
default device, directory, name, and types listed in Table 8-1. Table 
8-1 lists the default values for each file specification. 
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explicit octal declaration is specified (#), the 
sign indicator, if included, must precede the 
number sign. 

All switch values must be preceded by a colon (:). 


The switch specifications are interpreted in the 
context of the program to which they apply. The 
switch options applicable to MACRO-11 are 
described in Table 8-2 below. 

A syntax error detected in the command string causes MACRO—11 to 
output the following error message to the command output device: 

MAC — Command syntax error 


followed by a copy of the entire command string. 

At assembly time, you may want to override certain MACRO-11 directives 
appearing in the source program or to provide MACRO-11 with 
information establishing how certain files are to be handled during 
assembly. You can do so through one or more switches, which may be 
selectively invoked as additional parameters in each file 
specification. The available switches for use in MACRO-11 file 
specifications under RSX-11M/RS*-11M-PLUS are listed in Table 8-2. 


Table 8-2 

MACRO-11 File Specification Switches 


Switch 


Function 


/LI:arg 
/N L : a r g 


/EN:arg 
/DS:arg 


/ML (see Note) 


Listing control switches; these options accept 
ASCII switch values (arg) which are equivalent 
in function and name to and override the 
arguments of the .LIST and .NLIST directives 
specified in the source program (see Section 

6.1.1) . This switch overrides the arguments and 
remains in effect for the entire assembly 
process. 

Function control switches; these options accept 
ASCII switch values (arg) which are equivalent 
in function and name to and override the 
arguments of the .ENABL and .DSABL directives 
specified in the source program (see Section 

6.2.1) . This switch overrides the arguments and 
remains in effect for the entire assembly 
process. 

The /ML switch, which takes no accompanying 
switch values, indicates to MACRO-11 that an 
input file is a macro library file. As noted in 
Section 7.8, any macro that is defined 
externally must be identified in the .MCALL 
directive before it can be retrieved from a 
macro library file and assembled with the user 
program. In locating macro definitions, 
MACRO-11 initiates a fixed search algorithm, 

(continued on next page) 
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Table 8-2 (Cont.) 

MACRO-11 File Specification Switches 


Switch 


Function 




/ML (Cont.) beginning with the last user macro file 

specified, continuing in reverse order with each 
such file specified, and terminating, if 
necessary, with a search of the system macro 
library file. If a required macro definition is 
not found upon completion of the search, an 
error code (U) results in the assembly listing. 
This means that a user macro library file must 

be specified in the command line or by using the 

MACRO-11 .LIBRARY directive (see Section 6.10.1) 
prior to the source file(s) that use macros 
defined in the library file. 

MACRO-11 does not pre-scan the command line for 
macro libraries; when a new source file is 

needed, it parses the next input file 
specification. If that file specification 
contains the /ML switch, it is appended to the 
front of the library file list. As a result, a 
user macro library file must be specified in the 
command line prior to the source files which 
require it, in order to resolve macro 

definitions. 

/SP Spool listing output (default value). 

/NOSP Do not spool output. 

/CR:[arg] Produce a cross-reference listing (see Section 

8.3) . 



Switches for the object file are limited to /EN and /DS; when 
specified, they apply throughout the entire command string. Switch 
options for the listing file are limited to /LI, /NL, /SP, /CR, and 
/NOSP. Switches for input files are limited to /ML, /EN, and /DS; 
the option /ML applies only to the file immediately preceding the 
option so specified, whereas the /EN and /DS options, as noted above, 
are also applicable to subsequent files in the command string. 

Multiple occurrences of the same switch following a file specification 
must be avoided, because the accompanying values of a subsequent like 
switch specification override any previously-specified values. If two 
such switch values are desired, they can be specified in the form 
shown below: 

/LI:SRC:MEB 
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8.1.4 DCL Operating Procedures 

RSX-11M/RSX-11M-PLUS indicates its readiness to accept a command by 
prompting with the DCL prompt. In response to the prompt, enter the 
command string in one of the formats shown below: 

>MACRO[/qualifiers] 

FILE? f ilespec[/qualifier [s] ] [,filespec[/qualifiers] ] . . .] 
o r 

[DCL] >MACRO [/qualifiers] filespec [/qualifier [s] ] [ ,filespec [/qualifier [s] ] ,..] 


where: qualifiers 


filespec 


affect either the entire command string 
(command qualifiers) or the filespec 
(parameter qualifiers). See Table 8-3 for a 
description of the command qualifiers and 
Table 8-4 for a description of the parameter 
qualifiers. 

is the standard file specification shown in 
Section 8.4. 


You use the comma (,) to separate file specifications. MACRO-11 
concatenates all the files and then performs the assembly. 


«p 

4 


Table 8-3 

DCL Command Qualifiers 


Qualifier 

Function 

/[NO]CROSS_REFERENCE 

Suppresses or generates a 
cross-reference listing (see Section 
8.3). When the cross-reference is 
generated, a listing file is also 
generated, whether or not the /LIST 
qualifier is present in the command 
string. 


/NOCROSS_REFERENCE is the default. 

/DSABLE:a rg 
/ENABLE:a rg 
/DSABLE:(arg,arg...) 
/ENABLE: (arg ,arg...) 

Overrides the .DSABLE or .ENABLE 
assembler directives in the source 
program. When more than one argument 
is entered, arguments must be enclosed 
in parentheses and separated by 
commas. 


You can specify any of the following 
arguments with the /DSABLE or /ENABLE 
qualifier. 

Argument 


ABSOLUTE 

Enabling this function causes all 
relative addresses (address mode 
67) to be assembled as absolute 
addresses (address mode 37) . 


(continued on next page) 
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Table 8-3 (Cont.) 

DCL Command Qualifiers 


Qualifier 

Function 

ABSOLUTE (Cont.) 

By default, the ABSOLUTE argument 
is disabled. 

AUTO_MCALL 

Enabling the AUTO MCALL argument 
causes MACRO-11 to search all 
known macro libraries for a macro 
definition that matches any 
undefined symbols appearing in 
the opcode field of a MACRO-11 
statement. 


By default, this option is 
disabled and if MACRO-11 finds an 
unknown symbol in the opcode 
field, it either declares a (U) 
undefined symbol error, or 
declares the symbol as an 
external symbol, depending upon 
the GLOBAL argument described 
below. 

BINARY 

Enabling this function produces 
absolute binary output in 
FILES-11 format. 


By default, the BINARY argument 
is disabled. 

CARD_FORMAT 

This function, when enabled, 
treats columns 73 through the end 
of the line as comments. 


By default, the CARD FORMAT 

argument is disabled. 

CASE_MATCH 

Enabling the CASE MATCH argument 
causes the MACRO-11 conditional 
assembly directives .IF IDN/.IF 
DIF to be alphabetically case 
sensitive. 


By default these directives are 
not case sensitive. 

GLOBAL 

Disabling this function causes 
MACRO-11 to flag all undefined 
symbol references with an error 
code (U) on the assembly listing. 


By default, the GLOBAL argument 
is enabled and MACRO-11 treats 
all symbols that are undefined at 
the end of assembly pass 1 as 
default global references. 


(continued on next page) 
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Table 8-3 (Cont.) 

DCL Command Qualifiers 


Qualifier 

Function 

LOCAL 

Enabling the LOCAL argument 
causes the assembler to treat all 
symbols as local symbols. When 
enabled, all global symbols are 
flagged with the U (undefined 
symbol) error message. 


By default, the LOCAL argument is 
disabled. 

LOWER_CASE 

Enabling this function causes 
MACRO-11 to accept lower-case 
ASCII input. 


Disabling this function causes 
MACRO-11 to convert lower-case 
ASCII input to upper-case. 


By default, the LOWER CASE 

argument is enabled. 

REGISTER 

DEFINITIONS 

Disabling this function causes 
MACRO-11 to ignore the normal 
register definitions. 


By default, register definitions 
are enabled. 

TRUNCATION 

When this function is enabled, 
MACRO-11 performs floating-point 
truncation. 


When this function is disabled, 
MACRO-11 performs floating-point 
rounding. 


The TRUNCATION argument is 

disabled by default. 


(continued on next page) 
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Table 8-3 (Cont.) 

DCL Command Qualifiers 


Qualifier 


Function 





/[NO]LIST[:filespec] Specifies whether or not the assembler 

should create and print a listing 
file. You can include /LIST as a 
qualifier for either a command or a 
file specification. If /LIST 

qualifies the command, the listing 
file is both entered in your directory 
and printed on the line printer. If 
you do not include a file 
specification, the listing file has a 
.LST file type and is named after the 
last file named in the MACRO command. 
The listing file cannot be a library 
file. (The LINK command and all other 
language commands use the name of the 
first file named in the command as the 
default file name.) If /LIST qualifies 
a file specification, the file is 
entered in your directory but is not 
printed on the line printer. The 
listing file is named after the file 
it qualifies. 

The default is /NOLIST. 

/NOLIST is the default qualifier. 

/[NO]OBJECT[:filespec] Indicates whether or not the assembler 

should create an object module. If 
you do not include a file 
specification in the command line, the 
assembler creates an object file with 
the same file name as the source file 
and an .OBJ extension. 

/OBJECT is the default qualifier. 

Overrides the .LIST and .NLIST 
assembler directives that may be 
included in the source file. You can 
use any of the following arguments 
with the /SHOW qualifier. 


Controls the listing of macro 
expansion binary code. 

Controls listing of macro calls 
and repeat range expansions. 


/[NO]SHOW:a rg 
/[NO]SHOW:(arg,arg...) 

Argument 

BINARY 

CALLS 


(continued on next page) 
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Table 8-3 (Cont.) 

DCL Command Qualifiers 


Qualifier 


Function 

COMMENTS 


Controls listing of comments. 

CONDITIONALS 


Controls listing of unsatisfied 
conditional coding. 

CONTENTS 


Controls listing of the table of 
contents during assembly pass 1. 

COUNTER 


Controls listing of the current 
location counter field. 

DEFINITIONS 


Controls listing of macro 
definitions and repeat range 
expansions. 

EXPANSIONS 


Controls listing of macro 

expansions. 

EXTENSIONS 


Controls listing of binary 

expansions. 

LISTING_DIRECTIVES 


Controls listing of listing 
control directives without 
arguments, that is f directives 
that alter the listing level 
counter. 

OBJECT_BINARY 


Controls listing of the generated 
binary code. 

SEQUENCE_NUMBERS 


Controls listing of source line 
sequence numbers. 

SOURCE 


Controls listing of source lines. 

SYMBOLS 


Controls listing of the symbol 
table resulting from the 
assembly. 

/ [NO] WIDE 

When set to WIDE, the listing is 
printed in 132 column format. When 
set to /NOWIDE, the listing is printed 
in 80 column format. /NOWIDE is the 
default qualifier. 
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Table 8-4 

DCL Parameter Qualifiers 


Qualifier 


Function 


/LIBRARY Specifies that an input file is a macro library file. 

The assembler processes the files listed in the 
command line in reverse order. Therefore, a library 
file cannot be the last file in the command line. 




8.1.5 MACRO-11 Command String Examples 

1. The following command strings assemble the source file 

FILNAM.MAC into a relocatable object module named FILNAM.OBJ. 

MCR> MAC FILNAM=FILNAM 

DCL> MACRO 

FILE? FILNAM 

DCL> MACRO FILNAM 

2. The following command strings assemble the source file 

FILNAM.MAC and produce an object file with the name 
TESTA.OBJ. 

MCR> MAC TESTA=FILNAM 

DCL> MACRO/OBJECT:TESTA FILNAM 

3. The following command strings concatenate and assemble the 

source files named FILNAM.MLB, TESTA.MAC, SPAN3.MAC, and 

SHELL.MAC and create an object file named SHELL.OBJ. 

MCR> MAC SHELL=FILNAM/ML,TESTA,SPAN3,SHELL 

DCL> MACRO FILNAM/LIBRARY,TESTA,SPAN3,SHELL 

4. The following command strings produce an object module and an 
assembly listing. Any .LIST TTM or .LIST COM directives in 
the source file are ignored. The listing produced by this 
command has no comments included and is printed in wide 
format. 

MCR> MAC FILNAM,FILNAM/NL:TTM:COM=FILNAM 

DCL> MACRO/LIST/NOSHOW:COMMENTS/WIDE FILNAM 
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8.2 IAS MACRO-11 OPERATING PROCEDURES 

The following sections describe those MACRO-11 operating procedures 
that apply exclusively to the IAS system. 


8.2.1 Initiating MACRO-11 Under IAS 

The MACRO command, used under IAS, causes MACRO-11 to assemble one or 
more ASCII source files containing MACRO-11 statements into a 
relocatable binary object file. The assembler will also produce an 
assembly listing, followed by a symbol table listing. A 
cross-reference listing can also be produced by means of the 
/CROSSREFERENCE qualifier (see 8.3, below). 

You can input a MACRO-11 program either directly from the terminal 
(interactive mode) or from a batch file (batch mode). For interactive 
mode use the MACRO command which can be issued whenever the IAS 
Program Development System (PDS) is at command level, a condition 
signified by the appearance of the prompt: 

PDS > 

For batch mode use the $MACRO command. 

When the assembly is completed, MACRO-11 terminates operations and 
returns control to PDS. (Refer to the IAS User 1 s Guide for further 
information about interactive and batch mode operations.) 


8.2.2 IAS Command String 
Formats: 


Interactive Mode 


input 

PDS> MACRO qualifiers filespec /LIBRARY + ... 
or 


PDS> MACRO qualifiers 
input 

FILES? filespec /LIBRARY + ... 
Batch Mode 


$MACRO qualifiers 


input 

filespec /LIBRARY + ... 


where: 


input 

filespec 


is the specification of an input file 
(see Section 8.4) that contains MACRO-11 
source program code. When the program 
consists of multiple files, a plus sign 
(+) must be used to separate each file 
specification from the next. The "wild 
card" form of a file specification is 
not allowed. 


«p 
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1 ° 


/LIBRARY specifies that an input file is a macro 

library file. Library files hold the 
definitions of externally defined 
macros. As noted in Section 7.8, an 
externally defined macro must be 
identified in an .MCALL directive before 
it can be retrieved and assembled with 
the user program. When MACRO-11 
encounters an .MCALL directive, a search 
begins for the definitions of the macros 
1isted. 


The search order is important because a 
macro might have two different 
definitions in library files LIB1 and 
LIB2. For example, if you need the 
definition in LIB1, then you must place 
LIB1 after LIB2 in the command line 
because MACRO-11 searches the last file 
specified in the command line first, 
then moves backwards through the files 
given until all have been searched. 


If a macro's definition is not found in 
any of the files named by the user, 
MACRO-11 automatically searches the 
system macro library; if the definition 
is still not found, an error code (U) is 
generated in the assembly listing. 


qualifiers 


specifies one or more of the following: 


output 

/OBJECT[:fi1espec] 


/NOOBJECT 


produces an object file as 
specified by filespec (see Section 
8.4). The default is a file with 
the same filename as the last named 
source file and an .OBJ extension. 
/OBJECT is always the default 
condition. 

does not produce an object file. 


output 
/LIST[:filespec] 


/NOLIST 


produces an assembly listing file 
according to filespec (see Section 
8.4). If filespec is not 
specified, the listing is printed 
on the line printer. The default 
in interactive mode is /NOLIST and 
in batch mode is /LIST. 

does not produce a listing file. 
The default in interactive mode is 
/NOLIST and in batch mode is /LIST. 


NOTE 


When no listing file is specified, any 
errors encountered in the source program 
are displayed at the terminal from which 
MACRO-11 was initiated. 
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/CROSSREFERENCE[sargl...arg4] 

produces a cross-reference listing. 
Argl through arg4 are described in 
Section 8.3. This qualifier may be 
abbreviated to /C. 

A MACRO-11 command string can be specified using any one of the three 
formats shown above for the interactive and batch modes. In 
interactive mode, if the input file specification (filespec) does not 
begin on the same line as the MACRO command and its qualifiers, PDS 
prints the following prompting message: 

FILES? 

then waits for the user to specify the input file(s). 

In batch mode, the $MACRO command and its arguments must appear on the 
same line unless the PDS line continuation symbol (-) is used. 


8.2.3 IAS Indirect Command Files 
Format: 

@ filespec 
where: 

@ specifies that the name that follows is an 

indirect file. 

filespec is the file specification (see Section 8.4) of a 

file that contains a command string. The default 
extension for the file name is .CMD. 

The indirect command file facility of PDS can be used with MACRO-11 
command strings. This is accomplished by creating an ASCII file that 
contains the desired command strings (or portions thereof) in the 
forms shown in Section 8.2.2. When an indirect command file reference 
is used in a MACRO-11 command string, the contents of the specified 
file are taken as all or part of the command string. 

An indirect command file reference must always be the rightmost entry 
in the command (see Section 8.2.4 for examples). 


«p 
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8.2.4 IAS Command String Examples 

The following examples show typical PDS MACRO-11 command strings. 

1. PDS> MACRO /NOLIST 

FILES? A+BOOT.MAC;3 — 

In this example, the source files A.MAC and B00T.MAC;3 will | 

be assembled to produce an object file called BOOT.OBJ. No 

listing will be produced. _ 
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2. Where the indirect command file TEST.CMD contains the command 
string: 

MACRO/OBJECT:MYFILE A+B 
the command: 

PDS>@TEST 

causes MACRO-11 to assemble the two files A.MAC and B.MAC 
into an object file called MYFILE.OBJ. 

3. Where the indirect command file IND02.CMD contains the 
command string segment: 

ATEST/LIBRARY+BTEST+SRT1.021 

the command: 

PDS >MACRO/LIST:DK1:TST 0IND02 

causes MACRO-11 to assemble the files BTEST.MAC and SRT1.021 
using the macro library file ATEST.MAC to produce an object 
file named SRT1.0BJ. A listing file named TST.LST is placed 
on disk unit 1. 

4. $MACRO/LIST:DK 0:MICR/NOOBJECT - 
LIB1/LIBRARY+MICR.MAC;002 

In this example, the library file is assembled with the file 
MICR.MAC;002. The program listing file named MICR.LST is 
placed on disk unit 0. 



8.3 CROSS-REFERENCE PROCESSOR (CREF) 

The CREF processor is used to produce a listing that includes 
cross-references to symbols that appear in the source program. The 
cross-reference listing is appended to the assembly listing. Such 
cross-references are helpful in debugging and in reading long 
programs. 

A cross-reference listing can include up to four sections: 

1. User-defined symbols 

2. Macro symbols 

3. Register symbols 

4. Permanent symbols 
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To generate a cross-reference listing, specify the /CR switch in the 
MACRO-11 command string. Optional arguments can also be specified. 
The form of the switch is: 



where: 


SYM 

specifies 

user-defined symbols (default) 

MAC 

specifies 

macro symbols (default) 

REG 

specifies 

register symbols 

PST 

specifies 

permanent symbols 

SEC 

specifies 

program sections 

ERR 

specifies 

error lines (default) 


If you wish to generate listings for user-defined and macro symbols 
only, use /CR. No argument is necessary. 

However, if an argument is specified, only that type of 
cross-reference listing is generated. For example: 

/CR:SYM 

produces a cross-reference listing of user-defined symbols only. No 
listing of macro symbols is generated. Thus, to produce all six types 
of cross-reference listings, you must specify all six arguments (the 
order in which they are specified is not significant). Use a colon to 
separate arguments. For example: 

/CR:REG:SYM:MAC:PST:SEC:ERR 

The CREF processor (CRF) is more fully described in the Utilities 
Reference Manual supplied with your system. 

Figure 8-1 illustrates a complete cross-reference listing. In the 
listing, references are made in the form page-line. To make the 
listing more informative the CREF processor uses the following signs: 

Sign Meaning 

= somewhere in the source program the symbol listed is 

defined by a direct assignment statement. 

* destructive reference; at the line referenced by the 
processor the value of the symbol is changed (its 
previous contents destroyed). 

# at the line referenced by the processor the symbol 
listed is defined by a direct assignment statement, a 
colon sign (:) or a double colon sign (::). 


j 
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R50UNP MACRO 005.00 Saturday 08-Jan-83 11147 Paae S-l 
Cross reference table (CREF 005.00) 


R50UNP 2-16# 

SYMBOL 2-17 2-25 


R50UNP MACRO 005.00 Saturday 08-Jan-83 11147 Paae R-l 
Cross reference table (CREF V05.00) 


RO 

2-23* 

2-32* 

2-33* 

2-43 

2-45 


2-50* 

2-51* 

2-52 



R1 

2-18* 

2-23 




R2 

2-52* 





R3 

2-18* 

2-21* 

2-33 



R4 

2-16 

2-17* 

2-18 

2-25 

2-27* 

SP 

2-16* 

2-27 





R50UNP MACRO V05.00 Saturday 08-Jan-83 li:47 Pase C-l 
Cross reference table (CREF VOS.00) 


0-0 

. ABS. 0-0 
PUREI 2-14 

Figure 8-1 Sample CREF Listing 

8.4 IAS/RSX—11M/RSX—11M-PLUS FILE SPECIFICATION 
Format: 

dev:[g ,m]name.ext;ver 


where: 

dev: is the name of the device where the desired file 

resides. A device name consists of two characters 
followed by a 1- or 2-digit device unit number (octal) 
and a colon (for example, DPI:, DK0:, DT3:). The 
default device is specified in Table 8-1. The default 
device under IAS is established initially by the system 
manager for each user and can be changed through the 
SET command. 

[grin] is the User File Directory (UFD) code. This code 

consists of a group number (octal), a comma (,) and an 
owner (member) number (octal) all enclosed in brackets 
([]). An example of a UFD code is: [200,30]. 
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The default UFD is equivalent to the User 
Identification Code (UIC) given at log-in time. Under 
IAS, the UFD can be changed through the SET DEFAULT 
command. 

name is the filename and consists of one through nine 

alphanumeric characters. There is no default for a 
filename. 

.ext is a 1- to 3-alphanumeric character filename extension 

or type that is preceded by a period (.). An extension 
is normally used to identify the nature of the file. 
Default values depend on the context of the file 
specification and are as follows: 

.CMD = Indirect command (input) file 
.LST = A listing (print format) file 
.MAC = MACRO-11 source module (input file) 

.OBJ = MACRO-11 object module (output file) 

.CRF = Intermediate CREF input file created by 
MACRO-11. 


; ver 

is an octal number between 1 and 77777 
differentiate between versions of the 
number is prefixed by a semicolon (;). 

that 

same 

is used to 
file. This 


For input files, the 
version number of the 

default 
file that 

value 

exists 

is 

the 

highest 


For output files, the 

default 

value 

is 

the 

highest 


version number of the file that exists increased by 1. 
If no version number exists, the value 1 is used. 


This is the general form for a file specification in 
IAS/RSX-11M/RSX-11M-PLUS systems. Detailed information is provided in 
the applicable system user's guide or operating procedures manual (see 
Section 0.3 in the Preface). 


•* 



8.5 MACRO-11 ERROR MESSAGES UNDER IAS/RSX-11M/RSX-11M-PLUS 

MACRO-11 outputs an error message to the command output device when 
one of the error conditions described below is detected. MACRO-11 
prints below the error message the command line that caused the error. 
If the error is a .INCLUDE or a .LIBRARY directive file error, 
MACRO-11 prints below the error message both the source line and the 
command line that caused the error. 

MAC — Error message 
MACRO-11 source line 
MACRO-11 command line 

These error messages reflect operational problems and should not be 
confused with the error codes (see Appendix D) produced by MACRO-11 
during assembly. 
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All the error messages listed below, with the exception of the 
"MAC — Command I/O error" message, result in the termination of the 
current assembly; MACRO-11 then attempts to restart by reading 
another command line. In the case of a command I/O error, however, 
MACRO-11 exits, since it is unable to obtain additional command line 
input. 

MAC -- Command file/open failure 

Either the file from which MACRO-11 is reading a command could 
not be opened initially or between assemblies; or the indirect 
command file specified as "@filename" in the MACRO-11 command 
line could not be opened. See "OPEN FAILURE ON INPUT FILE". 

MAC — Command I/O error 

An error was returned by the file system during MACRO-ll's 
attempt to read a command line. This is an unconditionally fatal 
error, causing MACRO-11 to exit. No MACRO-11 restart is 
attempted when this message appears. 

MAC -- Command syntax error 

An error was detected in the syntax of the MACRO-11 command line. 


I 
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MAC — Illegal filename 

Neither the device name nor the filename was present in the input 
file specification (the input file specification was null), or a 
wild card convention (asterisk) was employed in an input or 

output file specification. 

Wildcard options (*) are not permitted in MACRO-11 file 
specifications. 

MAC — Illegal switch 

An illegal switch was specified for a file, an illegal value was 

specified with a switch, or an invalid use of a switch was 

detected by MACRO-11. 

MAC — .INCLUDE directive file error 

The file specified in the .INCLUDE statement either does not 

exist or is invalid, the device specified in the command line is 
not available, or the .INCLUDE stacking depth exceeds five. 


MAC — Indirect command syntax error 

The name of the indirect command file (@filename) specified in 
the MACRO-11 command line is syntactically incorrect. 

MAC -- Indirect file depth exceeded 

An attempt to exceed the maximum allowable number of nested 
indirect command files has occurred. (Three levels of indirect 
command files are permitted in MACRO-11.) 

MAC — Insufficient dynamic memory 

There is not enough physical memory available for MACRO-11 to 
page its symbol table. Reinstall MACRO-11 in a larger partition, 
or see Appendix F.3. 


MAC -- Invalid format in macro library 

The library file has been corrupted, or it was not produced by 
the Librarian Utility Program (LBR). 
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MAC -- I/O error on input file 

In reading a record from a source input file or macro library 
file, the file system detected an error; for example, a line 
containing more than 132(10) characters was encountered. This 
message may also indicate that a device problem exists or that 
either a source file or a macro library file has been corrupted 
with incorrect data. 

MAC — I/O error on macro library file 

Same meaning as I/O error on input file, except that the file is 
a macro library file and not a source input file. 

MAC -- I/O error on output file 

In writing a record to the object output file or the listing 
output file, an error was detected by the file system. This 
message may also indicate that a device problem exists or that 
the device is full. 


MAC -- I/O error on work file 

A read or write error occurred on the work file used to store the 
symbol table. This error is most likely caused by a problem on 
the device or by attempting to write to a device that is full. 

MAC — .LIBRARY directive file error 

The file specified in the .LIBRARY statement either does not 
exist or is invalid, the file specification in the .LIBRARY 
directive is for a non-random access device, the device specified 
in the command line is not available, or the .LIBRARY stacking 
depth exceeds the maximum depth allowed. 


MAC — Open failure on input file 

1. Specified device does not exist. 

2. The volume is not mounted. 

3. A problem exists with the device. 

4. Specified directory file does not exist. 

5. Specified file does not exist. 

6. User does not have access privilege to the file directory or 
to the file itself. 


MAC — Open failure on output file 

1. Specified device does not exist. 

2. The volume is not mounted. 

3. A problem exists with the device. 

4. Specified directory file does not exist. 

5. User does not have access privilege to the file directory. 

6. The volume is full or the device is write protected. 

7. There is insufficient space for File Control Blocks. 


MAC 


— 64K storage limit exceeded 
64K words of work file memory are available 
message indicates that the assembler has 
symbols (about 13,000 to 14,000) that it has 
Either the source program is too large 
contains a condition that leads to excessive 
macro expansion that recursively calls 
terminating condition. 


to MACRO-11. This 
generated so many 
run out of space, 
to start with, or it 
size, such as a 
itself without a 
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9.1 MACRO-11 UNDER RSTS 

The only way a MACRO-11 program can run on a RSTS system is through 
either the RT-11 or RSX run-time systems. 


9.1.1 RT-11 Through RSTS 

There are two ways to run a MACRO program under the RT-11 run-time 
system: 

1. Use the RT-11 Emulator. This is done by typing: SW RT11. 

The terminal will respond with the RT-11 prompt (a dot 
printed by the keyboard monitor). You can then use the RT-11 
commands (see Section 9.2). 

2. Type the command: RUN $MACRO.SAV. The terminal will respond 
with an asterisk (*) prompt. You can then enter a command 
string of the form: 

OBJFIL,LSTFIL=SRC...SRC6 


OBJFIL 

is an object (output) 
extension .OBJ. 

file 

wi th 

the 

default 

LSTFIL 

is a listing (output) 
extension .LST. 

file 

with 

the 

default 

SRC... 

are source (input) 

files 

with 

the 

default 

SRC6 

extension .MAC. Six 
in this command. 

input 

files 

are 

allowed 



9.1.2 RSX Through RSTS 

To run a MACRO program under the RSX run-time system, type the 
command: RUN $MAC.TSK. The terminal will respond with: 

MAO 

In answer you enter a command string of the form: 

OBJFIL,LSTFIL=SRC...SRCN 
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OBJFIL 

is an object (output) 
extension .OBJ. 

file 

with 

the 

default 

LSTFIL 

is a listing (output) 
extension .LST. 

file 

with 

the 

default 

SRC... 

SRCN 

are source (input) 
extension .MAC. 

files with 

the 

default 



NOTE 

There are other commands that can be 
used to call RT-11 and RSX but they are 
site dependent and so are not mentioned 
here. 


9.2 INITIATING MACRO-11 UNDER RT-11 

The following sections describe those MACRO-11 operating procedures 
that apply only to the RT-11 system. 

To call the MACRO-11 assembler from the system device, respond to the 
system prompt (a dot printed by the keyboard monitor) by typing: 

R MACRO 

When the assembler responds with an asterisk (*), it is ready to 
accept command string input. 




9.3 RT-11 COMMAND STRING 

Format: 

[dev:obj f dev:1ist,dev:cref/s:arg]=dev:srcl,src2,...,dev:srcn/s:arg 

where 

dev is any legal RT-11 device for output; any 

file-structured device for input 

obj is the file specification of the binary object file 

that the assembly process produces; the device for 
this file should not be TT or LP 

list is the file specification of the assembly and symbol 

listing that the assembly process produces 

cref is the file specification of the CREF temporary 

cross-reference file that the assembly process 
produces. (Omission of dev:cref does not preclude a 
cross-reference listing, however.) 

/s:arg is a set of file specification options and arguments 

(see Table 9-2). 


•i 

•i 
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srcl, 
src2 ,. . . 
srcn 


represent the ASCII source (input) files containing the 
MACRO-11 source program or the user-supplied macro 
library files to be assembled. You can specify as many 
as six source files. 


The following command string calls for an assembly that uses one 
source file plus the system MACRO library to produce an object file 
BINF.OBJ and a listing. The listing goes directly to the line 
printer. 


*DK:BINK.OBJ,LP:=DK:SRC.MAC 

All output file specifications are optional. The system does not 
produce an output file unless the command string contains a 
specification for that file. 


The system determines the file type of an output file specification by 
its position in the command string, as determined by the number of 
commas in the string. For example, to omit the object file, you must 
begin the command string with a comma. The following command produces 
a listing, including cross-reference tables, but not binary object 
files. 


* ,LP:/C= (source file specification) 

Notice that you need not include a comma after the final output file 
specification in the command string. 

Table 9-1 lists the default values for each file specification. 



Default 


Table 9-1 

File Specification Values 



File 

Default 

Device 

Default 

File Name 

Default 
File Type 

Object 

DK: 

Must specify 

.OBJ 

Listing 

Same as for object 
file 

Must specify 

. LST 

Cref 

DK: 

Must specify 

. TMP 

First source 

DK: 

Must specify 

.MAC 

Additional source 

Same as for preceding 
source file 

Must specify 

.MAC 

System MACRO 
Library 

System device SY: 

SYSMAC 

• SML 

User MACRO 

Library 

DK: if first file, 
otherwise same as for 
preceding source file 

Must specify 

.MLB 
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NOTE 


Some assemblies need more symbol table 
space than available memory can contain. 
When this occurs the system 
automatically creates a temporary work 
file called WRK.TMP to provide extended 
symbol table space. 


The default device for WRK.TMP is DK. 
To cause the system to assign a 
different device, enter the following 
command: 


.ASSIGN dev: WF 

where: dev is the file-structured 

device that will hold 
WRK.TMP. 


9.4 FILE SPECIFICATION OPTIONS 

At assembly time you may need to override certain MACRO directives 
appearing in the source programs. You may also need to direct 
MACRO-11 on the handling of certain files during assembly. You can 
satisfy these needs by using the switches described in Table 9-2. 


I 

I 

I 

I 

J 


Table 9-2 

File Specification 


Options 



Option 


Usage 


/L:arg Listing control switches; these options accept ASCII 

/N:arg switch values (arg) which are equivalent in function 

and name to the arguments of the .LIST and .NLIST 
directives specified in the source program (see 

Section 6.1.1). This switch overrides the arguments 
of the directives and remains in effect for the 

entire assembly process. 

/E:a rg Function control switches; these options accept ASCII 

/D:a rg switch values (arg) which are equivalent in function 

and name to the arguments of the .ENABL and .DSABL 
directives specified in the source program (see 

Section 6.2.1). This switch overrides the arguments 
of the directives and remains in effect for the 

entire assembly process. 

(continued on next page) 
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Table 9-2 (Cont.) 

File Specification Options 


Option 


Usage 


/M Indicates input file is MACRO library file. When the 

assembler encounters an .MCALL directive in the 
source code f it searches macro libraries according to 
their order of appearance in the command string. 
When it locates a macro record whose name matches 
that given in the .MCALL, it assembles the macro as 
indicated by that definition. Thus, if two or more 
macro libraries contain definitions of the same macro 
name, the macro library that appears rightmost in the 
command string takes precedence. 

Consider the following command string: 

* (output file specification)=ALIB/M, 

B LIB/M,XIZ 

Assume that each of the two macro libraries, ALIB.MLB 
and BLIB.MLB, contain a macro called .BIG, but with 
different definitions. Then, if source file XIZ 
contains a macro call .MCALL .BIG, the system 
includes the definition of .BIG in the program as it 
appears in the macro library BLIB. 

If the command string does not include the standard 
system macro library SYSMAC.SML, the system 
automatically includes it as the first source file in 
the command string. Therefore, if macro library 
ALIB.MLB contains a definition of a macro called .READ, 
that definition of .READ overrides the standard .READ 
macro definition in SYSMAC.SML. 

/C:arg Controls contents of cross-reference listing. 


The /M switch affects only the source file to which it is appended. 
The other options affect the entire command string. 


9.5 CROSS-REFERENCE (CREF) TABLE GENERATION OPTION 

A cross-reference (CREF) table lists all or a subset of the symbols in 
a source program, identifying the statements that define and use 
symbols. 


9.5.1 Obtaining a Cross-Reference Table 


To obtain a CREF 
command string, 
assembly listing 


table you must include 
Usually you include 
file specification. 


the /C:arg option in the 
the /C:arg option with the 
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If the command string does not include a cref file specification, the 
system automatically generates a temporary file on device DK:. If you 
need to have a device other than DK: contain the temporary cref file, 
you must include the devicref field in the command string. 

A complete CREF listing contains the following six sections: 

1. A cross reference of program symbols—labels used in the 
program and symbols followed by an operator. 

2. A cross reference of register symbols. These symbols are R0, 
Rl, R2, R3, R4, R5, SP, and PC. 

3. A cross reference of MACRO symbols--those symbols defined by 
.MACRO and .MCALL directives. 

4. A cross reference of permanent symbols—all operation 

mnemonics and assembler directives. 

5. A cross reference of program sections--the names you specify 
as operands of .CSECT or .PSECT directives. 

6. A cross reference of errors--the system groups and lists all 
flagged errors from the assembly by error type. 

You can include any or all of these six sections on the 
cross-reference listing by specifying the appropriate arguments with 
the /C option. These arguments are listed and described in Table 9-3. 




/C 


Table 9-3 
Option Arguments 



Argument CREF Section 

S User defined symbols 

R Register symbols 

M MACRO symbolic names 

P Permanent symbols including instructions and directives 

C Control and program sections 

E Error code grouping 



NOTE 

Specifying /C with no arguments is 
equivalent to specifying /C:S:M:E. That 
special case excepted, you must 
explicitly request each CREF section by 
including its arguments. No 
cross-reference file occurs if the /C 
option is not specified, even if the 
command string includes a CREF file 
specification. 
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9.5.2 Handling Cross-Reference Table Files 

When you request a cross-reference listing by means of the /C option, 
you cause the system to generate a temporary file, DK:CREF.TMP. 

If device DK: is write-locked or if it contains insufficient free 
space for the temporary file, you can allocate another device for the 
file. To allocate another device, specify a third output file in the 
command string; that is, include a dev:cref specification. (You must 
still include the /C option to control the form and content of the 
listing. The dev:cref specification is ignored if the /C option is 
not also present in the command string.) 

The system then uses the devrcref file instead of DK:CREF.TMP and 
deletes it automatically after producing the CREF listing. 

The following command string causes the system to use RK2:TEMP.TMP as 
the temporary CREF file. 

* ,LP:,RK2:TEMP.TMP=SOURCE/C 

Another way to assign an alternative device for the CREF.TMP file is 
to enter the following command prior to entering R MACRO: 

.ASSIGN dev:CF 

This method is preferred if you intend to do several assemblies, as it 
relieves you from having to include the dev:cref specification in each 
command string. If you enter the ASSIGN dev: CF command, and later 
include a cref specification in a command string, the specification in 
the command string prevails for that assembly only. 

The system lists requested cross-reference tables following the MACRO 
assembly listing. Each table begins on a new page. 

The system prints symbols and also symbol values, control sections, 
and error codes, if applicable, beginning at the left margin of the 
page. References to each symbol are listed on the same line, 
left-to-right across the page. The system lists references in the 
form P-L; where P is the page in which the symbol, control section, 
or error code appears, and L is the line number on the page. 

A number sign (#) next to a reference indicates a symbol definition. 
An asterisk (*) next to a reference indicates a destructive 
reference—an operation that alters the contents of the addressed 
location. 


9.5.3 MACRO-11 Error Messages Under RT-11 

MACRO-11 outputs an error message to the command output device when 
one of the error conditions described below is detected. MACRO-11 
prints below the error message the command line that caused the error. 
If the error is a .INCLUDE or a .LIBRARY directive file error, 
MACRO-11 prints below the error message both the source line and the 
command line that caused the error. 

?MACRO-s-Error message 
MACRO-11 source line 
MACRO-11 command line 
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The s in the error message represents the letter code that indicates 
the severity level of the error. 

These error messages reflect operational problems and should not be 
confused with the error codes (see Appendix D) produced by MACRO-11 
during assembly. 

Error Message Meaning 


?MACRO-F-Device full DEV: 

The output volume does not have sufficient 
room for an output file specified in the 
command string. 


7MACR0-F-Fi1e not found DEV:FILNAM.TYP 

An input file in the command line does not 
exist on the specified device. 

7MACR0-F-.INCLUDE directive file error 

The file specified in the .INCLUDE statement 
either does not exist or is invalid, the 
device specified in the command line is not 
available, or the .INCLUDE stacking depth 
exceeds five. 


?MACRO-F-Insufficient memory 

MACRO does not have the minimum amount of 
memory (1<SK words) necessary to run. 

?MACRO-F-Invalid command 

The command line contains a syntax error or 
specifies more than six input files. 

?MACRO-F-Invalid device 

A device specified in the command line does 
not exist on the system. 


?MACRO-F-Invalid macro library 

The library file has been corrupted or it was 

not produced by the RT-11 librarian, LIBR. 


7MACR0-F-Invalid option: /x 

The specified option was not recognized by 
the program. 

7MACR0-F-I/0 error on DEV:FILNAM.TYP 

A hardware error occurred while attempting to 
read from or write to the device on the 
specified file. 

7MACR0-F-I/0 error on work file 

MACRO failed to open, read, or write to its 
work file, WRK.TMP. 


j 
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7MACRO-F-.LIBRARY directive file error 

The file specified in the .LIBRARY statement 
either does not exist or is invalid, the file 
specification in the .LIBRARY directive is 
for a non-random access device, the device 
specified in the command line is not 
available, or the .LIBRARY stacking depth 
exceeds the maximum depth allowed. 

?MACRO-F-Protected file already exists DEV:FILNAM.TYP 

An attempt was made to create a file having 
the same name as an existing protected file. 

?MACRO-F-Storage limit exceeded (64K) 

MACRO'S Virtual Symbol Table can store 
symbols and macros up to 64K in any 
combination. Your program contains more than 
64K worth of one or both of these elements. 

?MACRO-W-I/O error on CREF file: CREF aborted 

MACRO ran out of device space while writing 
the cref file, or a hardware error has 
occurred. The cref file is aborted but 
assembly continues. 
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A.1 ASCII CHARACTER SET 


Even 

Parity 

Bit 

7-Bit 

Octal 

Code 

Character 

Remarks 

0 

000 

NUL 

Null, tape feed, CONTROL/SHIFT/P. 

1 

001 

SOH 

Start of heading; also SOM, start 
of message, CONTROL/A. 

1 

002 

STX 

Start of text; also EOA, end of 
address, CONTROL/B. 

0 

003 

ETX 

End of text; also EOM, end of 

message, CONTROL/C. 

1 

004 

EOT 

End of transmission (END); shuts 

off TWX machines, CONTROL/D. 

0 

005 

ENQ 

Enquiry (ENQRY); also WRU, 

CONTROL/E. 

0 

006 

ACK 

Acknowledge; also RU, CONTROL/F. 

1 

007 

BEL 

Rings the bell. CONTROL/G. 

1 

010 

BS 

Backspace; also FEO, format 
effector. backspaces some 
machines, CONTROL/H. 

0 

011 

HT 

Horizontal tab. CONTROL/I. 

0 

012 

LF 

Line feed or Line space (new line); 
advances paper to next line, 
duplicated by CONTROL/J. 

1 

013 

VT 

Vertical tab (VTAB). CONTROL/K. 

0 

014 

FF 

Form Feed to top of next page 
(PAGE). CONTROL/L. 

1 

015 

CR 

Carriage return to beginning of 
line; duplicated by CONTROL/M. 

1 

016 

SO 

Shift out; changes ribbon color to 
red. CONTROL/N. 

0 

017 

SI 

Shift in; changes ribbon color to 
black. CONTROL/O. 

1 

020 

DLE 

Data link escape. CONTROL/P (DC0)• 

0 

021 

DC1 

Device control 1; turns 
transmitter (READER) on, CONTROL/Q 
(X ON). 0 022 DC2 Device control 
2; turns punch or auxiliary on. 
CONTROL/R (TAPE, AUX ON). 

1 

023 

DC 3 

Device control 3; turns 
transmitter (READER) off, CONTROL/S 
(X OFF). 

0 

024 

DC 4 

Device control 4; turns punch or 
auxiliary off. CONTROL/T (AUX 
OFF) . 
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Even 

7-Bit 



Parity 

Octal 



Bit 

Code 

Character 

Remarks 

1 

025 

NAK 

Negative acknowledge; also ERR, 

ERROR. CONTROL/U. 

1 

026 

SYN 

Synchronous file (SYNC). 

CONTROL/V. 

0 

027 

ETB 

End of transmission block; also 
LEM, logical end of medium. 
CONTROL/W. 

0 

030 

CAN 

Cancel (CANCL). CONTROL/X. 

1 

031 

EM 

End of medium. CONTROL/Y. 

1 

032 

SUB 

Substitute. CONTROL/Z. 

0 

033 

ESC 

Escape. CONTROL/SHIFT/K. 

1 

034 

FS 

File separator. CONTROL/SHIFT/L. 

0 

035 

GS 

Group separator. CONTROL/SHIFT/M. 

0 

036 

RS 

Record separator. CONTROL/SHIFT/N. 

1 

037 

US 

Unit separator. CONTROL/SHIFT/O. 

1 

040 

SP 

Space. 

0 

041 

i 


0 

042 

it 


1 

043 

# 


0 

044 

$ 


1 

045 

% 


1 

046 

& 


0 

047 

i 

Accent acute or apostrophe. 

0 

050 

( 


1 

051 

> 


1 

052 

* 


0 

053 

+ 


1 

054 

r 


0 

055 

- 


0 

056 

0 


1 

057 

/ 


0 

060 

0 


1 

061 

1 


1 

062 

2 


0 

063 

3 


1 

064 

4 


0 

065 

5 


0 

066 

6 


1 

067 

7 


1 

070 

8 


0 

071 

9 


0 

072 

: 


1 

073 

r 


0 

074 

< 


1 

075 

= 


1 

076 

> 


0 

077 

? 


1 

100 

@ 


0 

101 

A 


0 

102 

B 


1 

103 

C 


0 

104 

D 


1 

105 

E 


1 

106 

F 


0 

107 

G 


0 

110 

H 


0 

111 

I 



j 

# 
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Even 

7-Bit 



Parity 

Octal 



Bit 

Code 

Character 

Remarks 

1 

112 

J 


0 

113 

K 


1 

114 

L 


0 

115 

M 


0 

116 

N 


1 

117 

0 


0 

120 

P 


1 

121 

Q 


1 

122 

R 


0 

123 

S 


1 

124 

T 


0 

125 

U 


0 

126 

V 


1 

127 

W 


1 

130 

X 


0 

131 

Y 


0 

132 

Z 


1 

133 

[ 

shift/k. 

0 

134 

\ 

shift/1. 

1 

135 

] 

shift/m. 

1 

136 


* 

0 

137 


** 

0 

140 


Accent grave. 

1 

141 

a 


1 

142 

b 


0 

143 

c 


1 

144 

d 


0 

145 

e 


0 

146 

f 


1 

147 

g 


1 

150 

h 


0 

151 

i 


0 

152 

j 


1 

153 

k 


0 

154 

1 


1 

155 

m 


1 

156 

n 


0 

157 

o 


1 

160 

P 


0 

161 

q 


0 

162 

r 


1 

163 

s 


0 

164 

t 


1 

165 

u 


1 

166 

V 


0 

167 

w 


0 

170 

X 


1 

171 

y 


1 

172 

z 


0 

173 



1 

174 



0 

175 


This code generated by ALTMODE. 

0 

176 


This code generated by prefix key 




(if present). 

1 

177 

DEL 

Delete, Rubout. 

* ~ Appears 

as # or 

on some machines. 

** _ Appears 

as < on 

some machines. 
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Character 

ASCII 

Octal 

Equivalent 

Radix-50 
Equivalent 

Space 

40 

0 

A-Z 

101-132 

1-32 

$ 

44 

33 

• 

56 

34 

Unused 


35 

0-9 

60-71 

36-47 


The maximum Radix-50 value is, thus, 

47*50**2+47*50+47=174777 

The following table provides a convenient means of translating between 
the ASCII character set and its Radix-50 equivalents. For example, 
given the ASCII string X2B, the Radix-50 equivalent is (arithmetic is 
performed in octal): 

X=113000 
2=002400 
B=000002 
X2B=115402 


Single Char. 

or Second Third 

First Char. Character Character 


Space 000000 Space 

A 003100 A 

B 006200 B 

C 011300 C 

D 014400 D 

E 017500 E 

F 022600 F 

G 025700 G 

H 031000 H 

I 034100 I 

J 037200 J 

K 042300 K 

L 045400 L 

M 050500 M 

N 053600 N 

0 056700 0 

P 062000 P 

Q 065100 Q 

R 070200 R 

S 073300 S 

T 076400 T 

U 101500 U 


000000 

Space 

000000 

000050 

A 

000001 

000120 

B 

000002 

000170 

C 

000003 

000240 

D 

000004 

000310 

E 

000005 

000360 

F 

000006 

000430 

G 

000007 

000500 

H 

000010 

000550 

I 

000011 

000620 

J 

000012 

000670 

K 

000013 

000740 

L 

000014 

001010 

M 

000015 

001060 

N 

000016 

001130 

0 

000017 

001200 

P 

000020 

001250 

Q 

000021 

001320 

R 

000022 

001370 

S 

000023 

001440 

T 

000024 

001510 

U 

000025 
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Single Char. 

or Second Third 

First Char. Character Character 


V 

104600 

V 

w 

107700 

w 

X 

113000 

X 

Y 

116100 

Y 

Z 

121200 

Z 

$ 

124300 

$ 

• 

127400 


Unused 

132500 

Unused 

0 

135600 

0 

1 

140700 

1 

2 

144000 

2 

3 

147100 

3 

4 

152200 

4 

5 

155300 

5 

6 

160400 

6 

7 

163500 

7 

8 

166600 

8 

9 

171700 

9 


001560 

V 

000026 

001630 

W 

000027 

001700 

X 

000030 

001750 

Y 

000031 

002020 

Z 

000032 

002070 

$ 

000033 

002140 

• 

000034 

002210 

Unused 

000035 

002260 

0 

000036 

002330 

1 

000037 

002400 

2 

000040 

002450 

3 

000041 

002520 

4 

000042 

002570 

5 

000043 

002640 

6 

000044 

002710 

7 

000045 

002760 

8 

000046 

003030 

9 

000047 
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MACRO-11 ASSEMBLY LANGUAGE AND ASSEMBLER DIRECTIVES 


B.l SPECIAL CHARACTERS 


Character 

Function 

: 

Label terminator 

= 

Direct assignment operator 

% 

Register term indicator 

tab 

Item terminator or field terminator 

space 

Item terminator or field terminator 

# 

Immediate expression indicator 

@ 

( 

Deferred addressing indicator 

Initial register indicator 

) 

Terminal register indicator 

, (comma) 

Operand field separator 

/ 

Comment field indicator 

+ 

Arithmetic addition operator or auto 
increment indicator 


Arithmetic subtraction operator or auto 
decrement indicator 

* 

Arithmetic multiplication operator 

/ 

Arithmetic division operator 

& 

Logical AND operator 

i 

Logical OR operator 

VI 

Double ASCII character indicator 

' (apostrophe) 

Single ASCII character indicator or 
concatenation indicator 

• 

Assembly location counter 

< 

Initial argument indicator 

> 

Terminal argument indicator 

Universal unary operator or argument 
indicator 

\ 

Macro call numeric argument indicator 

vertical tab 

Source line terminator 


B.2 SUMMARY OF ADDRESS MODE SYNTAX 


Symbols used 

n is 

R is 

E is 

ER is 

is 


in the table: 

an integer, 0 to 7, representing a register number 
a register expression 
an expression 

either a register expression or an expression whose value 
in the range 0 to 7. 
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Format 

Address 

Mode 

Name 

Address 

Mode 

Number 

Meaning 

R 

Register 

0n 

Register R contains the 

operand. 

@R or 
(ER) 

Register 
deferred 

In 

Register R contains the ad¬ 
dress of the operand. 

(ER) + 

Auto increment 

2n 

The contents of the register 
specified as (ER) are 
incremented after being used 
as the address of the operand. 

@(ER)+ 

Autoincrement 

Deferred 

3n 

The register specified as (ER) 
contains the pointer to the 
address of the operand; the 
register (ER) is incremented 
after use. 

-(ER) 

Autodecrement 

4n 

The contents of the register 
specified as (ER) are 
decremented before being used 
as the address of the operand. 

@—(ER) 

Autodecrement 

Deferred 

5n 

The contents of the register 
specified as (ER) are 
decremented before being used 
as the pointer to the address 
of the operand. 

E (ER) 

Index 

6n 

The expression E r plus the 
contents of the register 

specified as (ER), form the 
address of the operand. 

@E(ER) 

Index Deferred 

7n 

The expression E, plus the 
contents of the register 

specified as (ER), yield a 
pointer to the address of the 
operand. 

#E 

Immediate 

27 

The expression E is the 

operand itself. 

@#E 

Absolute 

37 

The expression E is the 

address of the operand. 

E 

Relative 

67 

The address of the operand E f 
relative to the instruction, 
follows the instruction. 

@E 

Relative 

Deferred 

77 

The address of the operand is 
pointed to by E whose address, 
relative to the instruction, 
follows the instruction. 










I 

Kj 


fi 
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B•3 ASSEMBLER DIRECTIVES 

The MACRO-11 assembler directives are summarized in the following 
table. For a detailed description of each directive, the table 
contains references to the appropriate sections in the body of the 
manual. 1 


Form 

Section 

Reference 

Operation 

i 

6.3.3 

7.3.7 

Followed by one ASCII character 
a single quote (apostrophe) 
generates a word which contains the 
7-bit ASCII representation of the 
character in the low-order byte and 
zero in the high-order byte. This 
character is also used as a 
concatenation indicator in the 
expansion of macro arguments. 

it 

6.3.3 

Followed by two ASCII characters a 
double quote generates a word which 
contains the 7-bit ASCII 
representation of the two 
characters. The first character is 
stored in the low-order byte; the 
second character is stored in the 
high-order byte. 

* Bn 

6.4.1.2 

A temporary radix control, causes 
the value n to be treated as a 
binary number. 

"Cexpr 

6.4.2.2 

A temporary numeric control, causes 
the expression's value to be ones- 
complemented. 

~Dn 

6.4.1.2 

A temporary radix control, causes 
the value n to be treated as a 
decimal number. 

~Fn 

6.4.2.2 

A temporary numeric control, causes 
the value n to be treated as a 
sixteen-bit floating-point number. 

c 

o 

< 

6.4.1.2 

A temporary radix control, causes 
the value n to be treated as an 
octal number. 

~Rccc 

6.3.7 

Converts ccc to Radix-50 form. 

.ASCII /string/ 

6.3.4 

Generates a block of data 
containing the ASCII equivalent of 
the character string (enclosed in 
delimiting characters), one 
character per byte. 
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ASSEMBLY LANGUAGE 

AND ASSEMBLER DIRECTIVES 


Section 

Operation 

Form 

Reference 

.ASCIZ /string/ 

6.3.5 

Generates a block of data 

containing the ASCII equivalent of 
the character string (enclosed in 
delimiting characters), one 
character per byte, with a zero 
byte terminating the specified 
string. 

.ASECT 

6.7.2 

Begins or resumes the absolute 

program section. 

.BLKB exp 

6.5.3 

Reserves a block of storage space 
whose length in bytes is determined 
by the specified expression. 

.BLKW exp 

6.5.3 

Reserves a block of storage space 
whose length in words is determined 
by the specified expression. 

.BYTE expl,exp2,. 

6.3.1 

Generates successive bytes of data; 
each byte contains the value of the 
corresponding specified expression. 

.CROSS syml,sym2, 

6.2.2 

Enables the cross-reference listing 
for the specified symbol list. If 
a symbol list is not specified, 
this directive reenables the 
cross-reference listing for all 
symbols in the program. 

•CSECT [name] 

6.7.2 

Begins or resumes named or unnamed 
relocatable program section. This 
directive is provided for 
compatibility with other PDP-11 
assemblers. 

.DSABL arg 

6.2.1 

Disables the function specified by 
the argument. 

.ENABL arg 

6.2.1 

Enables (invokes) the function 

specified by the argument. 

.END [exp] 

6.6 

Indicates the logical end of the 
source program. The optional 
argument specifies the transfer 
address where program execution is 
to begin. 

. ENDC 

6.9.1 

Indicates the end of a conditional 
assembly block. 

.ENDM [name] 

7.1.2 

Indicates the end of the current 
repeat block, indefinite repeat 
block, or macro definition. The 
optional name, if used, must be 
identical to the name specified in 
the macro definition. 


I 


J 

J 


•I 


I 
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I 





Form 

Section 

Reference 

Operation 

. ENDR 

7.7 

Indicates the end of the current 
repeat block. This directive is 
provided for compatibility with 
other PDP-11 assemblers. 

.ERROR exp;text 

7.5 

A user-invoked error directive, 
causes output to the listing file 
or the command output device 
containing the optional expression 
and the statement containing the 
directive. 

. EVEN 

6.5.1 

Ensures that the current location 
counter contains an even address by 
adding 1 if it is odd. 

.FLT2 argl ,arg2 ,... 

6.4.2.1 

Generates successive 2-word 
floating-point equivalents for the 
floating-point numbers specified as 
arguments. 

.FLT4 argl,arg2 , . . . 

6.4.2.1 

Generates successive 4-word 
floating-point equivalents for the 
floating-point numbers specified as 
arguments. 

.GLOBL syml,sym2,... 

6.8.1 

Defines the symbol(s) specified as 
global symbol(s). 

.IDENT /string/ 

6.1.4 

Provides a means of labeling the 
object module with the program 
version number. The version number 
is the Radix-50 string appearing 
between the paired delimiting 
characters. 

.IF cond,argl 

6.9.1 

Begins a conditional assembly block 
of source code which is included in 
the assembly only if the stated 
condition is met with respect to 
the argument(s) specified. 

. IFF 

6.9.2 

Appears only within a conditional 
assembly block, indicating the 
beginning of a section of code to 
be assembled if the condition upon 
entering the block tests false. 

• IFT 

6.9.2 

Appears only within a conditional 
assembly block, indicating the 
beginning of a section of code to 
be assembled if the condition upon 
entering the block tests true. 



I 
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I 


Form 


Section 

Reference Operation 



• IFTF 


• IIF cond,arg, 
statement 


.INCLUDE string 


• IRP sym f 
<argl,arg2 ,. . .> 


.IRPC sym,<string> 


.LIBRARY string 


.LIMIT 


.LIST [arg] 


.MACRO name ,argl f 
arg2,... 


.MCALL argl,arg2,... 


6.9.2 


6.9.3 


6 . 10.2 


7.6.1 


7.6.2 


Appears only within a conditional 
assembly block, indicating the 
beginning of a section of code to 
be assembled unconditionally. 

Acts as a 1-line conditional 
assembly block where the condition 
is tested for the argument 
specified. The statement is 
assembled only if the condition 
tests true. 

Inserts a specified source file 
within the source file currently 
being used. 

Indicates the beginning of an 
indefinite repeat block in which 
the symbol specified is replaced 
with successive elements of the 
real argument list enclosed within 
angle brackets. 

Indicates the beginning of an 
indefinite repeat block in which 
the specified symbol takes on the 
value of successive characters, 
optionally enclosed within angle 
brackets. 


6.10.1 Adds a specified file name to a 
macro library list that is 
searched. 

6.5.4 Reserves two words into which the 

Task Builder inserts the low and 
high addresses of the task image. 

6.1.1 Without an argument, the .LIST 

directive increments the listing 
level count by 1. With an 
argument, this directive does not 
alter the listing level count, but 
formats the assembly listing 



according 
specified. 

to 

the 

argument 

7.1.1 

Indicates 

the 

start 

of a macro 


definition having the specified 
name and the following dummy 
a rguments. 


7.8 Specifies the symbolic names of the 

user or system macro definitions 
required in the assembly of the 
current user program, but which are 
not defined within the program. 





I 


B-6 











MACRO 11 ASSEMBLY LANGUAGE AND ASSEMBLER DIRECTIVES 



Jo 




Form 


Section 

Reference Operation 


.MDELETE namel,name2,... 7.9 

.MEXIT 7 . 1.3 


.NARG symbol 7.4.1 


.NCHR symbol,<string> 7.4.2 


.NLIST [arg] 6.1.1 


.NOCROSS syml,sym2,... 6.2.2 


.NTYPE symbol,aexp 7.4.3 

• ODD 6.5.2 

.PACKED 6.3.8 

.PAGE 6.1.5 

•PRINT exp;text 7.5 


.PSECT name,attl,... 6.7.1 

a ttn 


Deletes the definitions of the 
specified macro(s), freeing virtual 
memory. 

Causes an exit from the current 
macro expansion or indefinite 
repeat block. 

Appearing only within a macro 
definition, equates the specified 
symbol to the number of arguments 
in the macro call currently being 
expanded. 

Appearing anywhere in a source 
program, equates the symbol 
specified to the number of 
characters in the specified string. 

Without an argument, decrements the 
listing level count by 1. With an 
argument, this directive suppresses 
that portion of the listing 
specified by the argument. 

Disables the cross-reference 
listing for the listed symbols. If 
a symbol list is not specified, 
this directive disables the 
cross-reference listing for all 
symbols in the program. 

Appearing only within a macro 
definition, equates the symbol to 
the 6 -bit addressing mode of the 
specified address expression. 

Ensures that the current location 
counter contains an odd address by 
adding 1 if it is even. 

Causes a decimal number of 31(10) 
digits or less to be packed 2 
digits per byte. 

Causes the assembly listing to skip 
to the top of the next page and to 
increment the page count. 

User-invoked message directive; 
causes output to the listing file 
or the command output device 
containing the optional expression 
and the statement containing the 
directive. 

Begins or resumes a named or 
unnamed program section having the 
specified attributes. 


I 
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Section 

Reference Operation 


•RADIX n 6.4.1.1 

Alters the current program radix to 
n, where n is 2, 8, or 10. 

.RAD50 /string/ 6.3.6 

Generates a block of data 
containing the Radix-50 equivalent 
of the character string enclosed 
within delimiting characters. 

.REM comment-character 6.1.6 

Allows a programmer to insert a 
block of comments into a MACRO-11 
source program without having to 
precede the comment lines with the 
comment character (;). 

.REPT exp 7 » 7 

Begins a repeat block; causes the 
section of code up to the next 
.ENDM or .ENDR directive to. be 
repeated the number of times 

specified as exp. 

.RESTORE 6.7.4 

Retrieves a previously .SAVEd 
program section from the top of the 
program section context stack 
leaving the current program section 
in effect. 

.SAVE 6.7.3 

Stores the current program section 
on the top of the program section 
context stack leaving the current 
program section in effect. 

.SBTTL string 6.1.3 

Causes the specified string to be 
printed as part of the assembly 
listing page header. The string 
component of each .SBTTL directive 
is collected into a table of 
contents at the beginning of the 
assembly listing. 

•TITLE string 6.1.2 

Assigns the first six Radix-50 

characters in the string as an 
object module name and causes the 
string to appear on each page of 
the assembly listing. 

.WEAK syml,sym2 , . . . 6.8.2 

Specifies symbols that are either 
defined externally in another 
module or are defined globally in 
the current module. 

.WORD expl, exp2,.. 6.3.2 

Generates successive words of data; 
each word contains the value of the 
corresponding specified expression. 


.WORD expl,exp2,.. 











APPENDIX C 


PERMANENT SYMBOL TABLE (PST) 


The mnemonics for the PDP-11 operation (op) codes and MACRO-11 
assembler directives are stored in the Permanent Symbol Table (PST). 
The PST contains the symbols that are automatically recognized by 
MACRO-11. 1 


For a detailed description of the op codes, see the 
Handbook. 


PDP-11 Processor 


C.l OP CODES 


Instruction 

Mnemonic 

Octal 

Value 

Operation 

ADC 

005500 

Add Carry 

ADCB 

105500 

Add Carry (Byte) 

ADD 

060000 

Add Source To Destination 

ASH 

072000 

Shift Arithmetically 

ASHC 

073000 

Arithmetic Shift Combined 

ASL 

006300 

Arithmetic Shift Left 

AS LB 

106300 

Arithmetic Shift Left (Byte) 

ASR 

006200 

Arithmetic Shift Right 

ASRB 

106200 

Arithmetic Shift Right (Byte) 

BCC 

103000 

Branch If Carry Is Clear 

BCS 

103400 

Branch If Carry Is Set 

BEQ 

001400 

Branch If Equal 

BGE 

002000 

Branch If Greater Than Or Equal 

BGT 

003000 

Branch If Greater Than 

BHI 

101000 

Branch If Higher 

BHIS 

103000 

Branch If Higher Or Same 

BIC 

040000 

Bit Clear 

BICB 

140000 

Bit Clear (Byte) 

BIS 

050000 

Bit Set 

BISB 

150000 

Bit Set (Byte) 

BIT 

030000 

Bit Test 

BITB 

130000 

Bit Test (Byte) 

BLE 

003400 

Branch If Less Than Or Equal 

BLO 

103400 

Branch If Lower 

BLOS 

101400 

Branch If Lower Or Same 

BLT 

002400 

Branch If Less Than 

BMI 

100400 

Branch If Minus 

BNE 

001000 

Branch If Not Equal 

BPL 

100000 

Branch If Plus 

BPT 

000003 

Breakpoint Trap 

BR 

000400 

Branch Unconditional 
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I 


Instruction 

Mnemonic 

Octal 

Value 

Operation 

BVC 

102000 

Branch If Overflow Is Clear 

BVS 

102400 

Branch If Overflow Is Set 

CALL 

004700 

Jump To Subroutine (JSR PC,xxx) 

CALLR 

000100 

Jump (JMP addr) 

CCC 

000257 

Clear All Condition Codes 

CLC 

000241 

Clear C Condition Code Bit 

CLN 

000250 

Clear N Condition Code Bit 

CLR 

005000 

Clear Destination 

CLRB 

105000 

Clear Destination (Byte) 

CLV 

000242 

Clear V Condition Code Bit 

CLZ 

000244 

Clear Z Condition Code Bit 

CMP 

020000 

Compare Source To 

Destination 

CMPB 

120000 

Compare Source To 

Destination (Byte) 

COM 

005100 

Complement Destination 

COMB 

105100 

Complement Destination 
(Byte) 

DEC 

005300 

Decrement Destination 

DECB 

105300 

Decrement Destination 
(Byte) 

DIV 

071000 

Di v ide 

EMT 

104000 

Emulator Trap 

FADD 

075000 

Floating Add 

FDIV 

075030 

Floating Divide 

FMUL 

075020 

Floating Multiply 

FSUB 

075010 

Floating Subtract 

HALT 

000000 

Halt 

INC 

005200 

Increment Destination 

INCB 

105200 

Increment Destination 
(Byte) 

IOT 

000004 

Input/Output Trap 

JMP 

000100 

Jump 

JSR 

004000 

Jump To Subroutine 

MARK 

006400 

Mark 

MED6X 

076600 

PDP-11/60 Maintenance 

MED74C 

076601 

PDP-11/74 CIS Maintenance 

MFPI 

006500 

Move From Previous 

Instruction Space 

MFPS 

106700 

Move from PS 

(LSI-11 , LSI-11/2 3, LSI-11/2) 

MFPT 

000007 

Move From Processor Type 

MOV 

010000 

Move Source To Destination 

MOVB 

110000 

Move Source To Destination 
(Byte) 

MTPI 

006600 

Move To Previous 

Instruction Space 

MTPS 

106400 

Move to PS 

(LSI-11, LSI-11/23, LSI-11/2) 

MUL 

070000 

Multiply 

NEG 

005400 

Negate Destination 

NEGB 

105400 

Negate Destination (Byte) 

NOP 

000240 

No Operation 

RESET 

000005 

Reset External Bus 

RETURN 

000207 

Return From Subroutine (RTS PC) 

ROL 

006100 

Rotate Left 

ROLB 

106100 

Rotate Left (Byte) 

ROR 

006000 

Rotate Right 

RORB 

106000 

Rotate Right (Byte) 


J 




I 
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*0 


Instruction 

Mnemonic 

Octal 

Value 

Operation 

RTI 

000002 

Return From Interrupt 
(Permits a trace 
trap) 

RTS 

000200 

Return From Subroutine 

RTT 

000006 

Return From Interrupt 
(inhibits trace trap) 

SBC 

005600 

Subtract Carry 

SBCB 

105600 

Subtract Carry (Byte) 

see 

000277 

Set All Condition Code Bits 

SEC 

000261 

Set C Condition Code Bit 

SEN 

000270 

Set N Condition Code Bit 

SEV 

000262 

Set V Condition Code Bit 

SEZ 

000264 

Set Z Condition Code Bit 

SOB 

077000 

Subtract One And Branch 

SUB 

160000 

Subtract Source From 

Destination 

SWAB 

000300 

Swap Bytes 

SXT 

006700 

Sign Extend 

TRAP 

104400 

Trap 

TST 

005700 

Test Destination 

TSTB 

105700 

Test Destination (Byte) 

TSTSET 

007200 

Test Destination And Set Low Bit 

WAIT 

000001 

Wait For Interrupt 

WRTLCK 

007300 

Read/Lock Destination. Write/Unlock 

R0 Into Destination 

XFC 

076700 

Extended Function Code 

XOR 

074000 

Exclusive OR 


fi 


COMMERCIAL INSTRUCTION SET (CIS) OP CODES 

Every operation listed in the CIS table has two instruction mnemonics. 
The suffix "I", attached to every second mnemonic, indicates that the 
addresses are inline. The inline instructions require two arguments; 
the other instructions (excepting L2DN and L3DN) require no arguments. 


Instruction 

Mnemonic 

Octal 

Value 

Operation 

ADDN 

076050 

Add Numeric 

ADDNI 

076150 

Add Numeric 

ADDP 

076070 

^dd Packed 

ADDPI 

076170 

Add Packed 

ASHN 

076056 

Arithmetic Shift Numeric 

ASHNI 

076156 

Arithmetic Shift Numeric 

ASHP 

076076 

Arithmetic Shift Packed 

ASHPI 

076176 

Arithmetic Shift Packed 

CMPC 

076044 

Compare Character String 

CMPCI 

076144 

Compare Character String 

CMPN 

076052 

Compare Numeric 

CMPNI 

076152 

Compare Numeric 

CMPP 

076072 

Compare Packed 

CMPPI 

076172 

Compare Packed 

CVTLN 

076057 

Convert Long To Numeric 

CVTLNI 

076157 

Convert Long To Numeric 

CVTLP 

076077 

Convert Long To Packed 


I 
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Instruction 


Octal 

Operation 

Mnemonic 


Value 

CVTLPI 


076177 

Convert Long To Packed 

CVTNP 


076055 

Convert Numeric To Packed 

CVTNPI 


076155 

Convert Numeric To Packed 

CVTPN 


076054 

Convert Packed To Numeric 

CVTPNI 


076154 

Convert packed To Numeric 

DIVP 


076075 

Divide Decimal 

DIVPI 


076175 

Divide Decimal 

LOCC 


076040 

Locate Character 

LOCCI 


076140 

Locate Character 

L2DN* 


07602N 

Load 2 Descriptors @(RN)+ 

L3DN* 


07606N 

Load 3 Descriptors @(RN)+ 

MATC 


076045 

Match Character 

MATCI 


076145 

Match Character 

MOVC 


076030 

Move Character 

MOVCI 


076130 

Move Character 

MOVRC 


076031 

Move Reverse Justified Character 

MOVRCI 


076131 

Move Reverse Justified Character 

MOVTC 


076032 

Move Translated Character 

MOVTCI 


076132 

Move Translated Character 

MULP 


076074 

Multiply Decimal 

MULPI 


076174 

Multiply Decimal 

SCANC 


076042 

Scan Character 

SCANCI 


076142 

Scan Character 

SKPC 


076041 

Skip Character 

SKPCI 


076141 

Skip Character 

SPANC 


076043 

Span Character 

S PANCI 


076143 

Span Character 

SUBN 


076051 

Subtract Numeric 

SUBNI 


076151 

Subtract Numeric 

SUBP 


076071 

Subtract Packed 

SUBPI 


076171 

Subtract Packed 

* where N=0.. 

.7 



FLOATING POINT 

PROCESSOR OP 

CODES 

Instruction 


Octal 

Operation 

Mnemonic 


Value 

ABSD 


170600 

Make Absolute Double 

ABSF 


170600 

Make Absolute Floating 

ADDD 


172000 

Add Double 

A DDF 


172000 

Add Floating 

CFCC 


170000 

Copy Floating Condition 




Codes 

CLRD 


170400 

Clear Double 

CLRF 


170400 

Clear Floating 

CMPD 


173400 

Compare Double 

CMPF 


173400 

Compare Floating 

DIVD 


174400 

Divide Double 

DIVF 


174400 

Divide Floating 

LDCDF 


177400 

Load And Convert From 




Double To Floating 

LDCFD 


177400 

Load And Convert From 




Floating To Double 

LDCID 


177000 

Load And Convert Integer To 


Double 


«P 

oi 


•k 
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I 





Instruction 

Mnemonic 

Octal 

Value 

Operation 

LDCIF 

177000 

Load And Convert Integer To 

Floating 

LDCLD 

177000 

Load And Convert Long 

Integer To Double 

LDCLF 

177000 

Load And Convert Long 

Integer To Floating 

LDD 

172400 

Load Double 

LDEXP 

176400 

Load Exponent 

LDF 

172400 

Load Floating 

LDFPS 

170100 

Load FPPs Program Status 

MFPD 

106500 

Move From Previous Data 

Space 

MODD 

171400 

Multiply And Integerize 

Double 

MODF 

171400 

Multiply And Integerize 

Floating 

MTPD 

106600 

Move To Previous Data Space 

MULD 

171000 

Multiply Double 

MULF 

171000 

Multiply Floating 

NEGD 

170700 

Negate Double 

NEGF 

170700 

Negate Floating 

SETD 

170011 

Set Double Mode 

SETF 

170001 

Set Floating Mode 

SETI 

170002 

Set Integer Mode 

SETL 

170012 

Set Long Integer Mode 

SPL 

000230 

Set Priority Level 

STA0 

170005 

Diagnostic Floating Point 

STB0 

170006 

Diagnostic Floating Point 

STCDF 

176000 

Store And Convert From 

Double To Floating 

STCDI 

175400 

Store And Convert From 

Double To Integer 

STCDL 

175400 

Store And Convert From 

Double To Long Integer 

STCFD 

176000 

Store And Convert From 

Floating To Double 

STCFI 

175400 

Store And Convert From 

Floating To Integer 

STCFL 

175400 

Store And Convert From 

Floating To Long Integer 

STD 

174000 

Store Double 

STEXP 

175000 

Store Exponent 

STF 

174000 

Store Floating 

STFPS 

170200 

Store FPPs Program Status 

STST 

170300 

Store FPPs Status 

SUBD 

173000 

Subtract Double 

SUBF 

173000 

Subtract Floating 

TSTD 

170500 

Test Double 

TSTF 

170500 

Test Floating 
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PERMANENT SYMBOL TABLE (PST) 

C.2 MACRO-11 DIRECTIVES 

The MACRO-11 directives that follow are described in greater detail in 
Appendix B. 

Directive Function 


.ASCII 

.ASCIZ 

.ASECT 

. BLKB 

. BLKW 

.BYTE 

.CROSS 

.CSECT 

.DSABL 
.ENABL 
. END 
. ENDC 
. ENDM 

. ENDR 

.ERROR 

. EVEN 
. FLT2 

. FLT4 

.GLOBL 

.IDENT 


.IF 

.IFF 

. IFT 

. IFTF 

• I IF 

.INCLUDE 

• IRP 


. IRPC 


.LIBRARY 


Translates character string to ASCII equivalents. 
Translates character string to ASCII equivalents; 
inserts zero byte as last character. 

Begins absolute program section (provided for 
compatibility with other PDP-11 assemblers). 
Reserves byte block in accordance with value of 
specified argument. 

Reserves word block in accordance with value of 
specified argument. 

Generates successive byte data in accordance with 
specified arguments. 

Enables cross-reference listing for specified 
symbols; enables cross-reference for all symbols. 
Begins relocatable program section (provided for 
compatibility with other PDP-11 assemblers). 
Disables specified function. 

Enables specified function. 

Defines logical end of source program. 

Defines end of conditional assembly block. 

Defines end of macro definition, repeat block, or 
indefinite repeat block. 

Defines end of current repeat block (provided for 
compatibility with other PDP-11 assemblers). 

Outputs diagnostic message to listing file or 
command output device. 

Word-aligns the current location counter. 

Causes two words of storage to be generated for 
each floating-point argument. 

Causes four words of storage to be generated for 
each floating-point argument. 

Declares global attribute for specified symbol(s). 
Labels object module with specified program 
version number. 

Begins conditional assembly block. 

Begins subconditional assembly block (if 
conditional assembly block test is false). 

Begins subconditional assembly block (if 
conditional assembly block test is true). 

Begins subconditional assembly block (whether 
conditional assembly block test is true or false). 
Assembles immediate conditional assembly statement 
(if specified condition is satisfied). 

Inserts specified source file within source file 
currently being used. 

Begins indefinite repeat block; replaces 

specified symbol with specified successive real 
a rguments. 

Begins indefinite repeat block; replaces 

specified symbol with value of successive 
characters in specified string. 

Adds a specified file name to a macro library list 
that is searched. 


«p 
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Directive 


Function 


.LIMIT 

.LIST 

.MCALL 

.MDELETE 
.MEXIT 

.NARG 

• NCHR 

•NLIST 

.NOCROSS 

.NTYPE 

.ODD 

.PACKED 

.PAGE 

.PRINT 

.PSECT 

.RADIX 
.RAD50 

.REM 

.REPT 
.RESTORE 
.SAVE 
.SBTTL 
.TITLE 

.WEAK 

.WORD 


Reserves two words of storage for high and low 
addresses of task image. 

Controls listing level count and format of 

assembly listing. .MACRO denotes start of macro 
definition. 

Identifies required macro definition(s) for 
assembly. 

Deletes the definitions of the specified macro(s). 
Exit from current macro definition or indefinite 
repeat block. 

Equates specified symbol to the number of 

non-keyword arguments in the macro expansion. 
Equates specified symbol to the number of 

characters in the specified character string. 
Controls listing level count and suppresses 
specified portions of the assembly listing. 
Disables cross-reference listing for specified 
symbols; disables cross-reference listing for all 
symbols. 

Equates specified symbols to the addressing mode 
of the specified argument. 

Byte-aligns the current location counter. 

Generates packed decimal data, 2 digits per byte. 
Advances form to top of next page. 

Prints specified message on command output device. 
Begins specified program section having specified 
attributes. 

Changes current program radix to specified radix. 
Generates data block having Radix-50 equivalents 
of specified character string. 

Inserts a block of comments into a MACRO-11 source 
program without having to precede comments lines 
with the comment character (;). 

Begins repeat block and replicates it according to 
the value of the specified expression. 

Stores the current program section context on the 
top of the program section context stack. 

Retrieves the program section from the top of the 
program section context stack. 

Prints specified subtitle text as the second line 
of the assembly listing page header. 

Prints specified title text as object module name 
in the first line of the assembly listing page 
header. 

Specifies symbols that are either defined 
externally in another module or are defined 
globally in the current module. 

Generates successive word data in accordance with 
specified arguments. 
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1 ° 

ERROR MESSAGES 



An error code is printed as the first character in 
containing an error. This error code identifies the 
detected during the processing of the line. Example: 


a source line 
error condition 


Q 26 000236 010102 


MOV R1,R2,A 


The extraneous argument A in the MOV instruction above causes the line 
to be flagged with a Q (syntax) error. 


Error Code Meaning 





A 


Assembly error. Because many different conditions 
produce this error message, the directives which 
may yield a general assembly error have been 
categorized below to reflect these error 
conditions: 


CATEGORY 1: 


ILLEGAL ARGUMENT SPECIFIED. 

2 , 8 , 


.RADIX — A value other than 
specified as a new radix. 


or 


10 


is 


• LIST/•NLIST — Other than a legally defined 
argument (see Table 6-2) is specified with the 
directive. 


.ENABL/.DSABL — Other than a legally defined 
argument (see Table 6-3) is specified with the 
directive, or the attribute arguments of a 
previously declared program section. 


•PSECT — Other than a legally defined argument 
(see Table 6-4) is specified with the 
directive, or the attribute arguments of a 
previously declared program section change (see 
Section 6.7.1.1). 

.IF/.IIF — Other than a legally defined 
conditional test (see Table 6-6) or an illegal 
argument expression value is specified with the 
directive. 


.MACRO An illegal or duplicate symbol found 
in dummy argument list. 
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Error Code 


Meaning 


A (cont.) .TITLE — Program name is not specified in the 

directive, or first non-blank character 
following the directive is a non-Radix-50 
character. 

.IRP/.IRPC — No dummy argument is specified in 
the directive. 

.NARG/.NCHAR/.NTYPE — No symbol is specified 
in the directive. 

.IF/.IIF — No conditional argument is 
specified in the directive. 

CATEGORY 3: UNMATCHED DELIMITER/ILLEGAL ARGUMENT 
CONSTRUCTION. 

.ASCII/.ASCIZ/.RAD50/.IDENT -- Character string 
or argument string delimiters do not match, or 
an illegal character is used as a delimiter, or 
an illegal argument construction is used in the 
d i rective. 

.NCHAR — Character string delimiters do not 
match, or an illegal character is used as a 
delimiter in the directive. 

CATEGORY 4: GENERAL ADDRESSING ERRORS. 

This type of error results from one of several 
possible conditions: 

1. Permissible range of a branch instruction 
(from -128(10) to +127(10) words) has been 
exceeded. 

2. A statement makes invalid use of the 
current location counter. For example, a 
".=expression" statement attempts to force 
the current location counter to cross 
program section (.PSECT) boundaries. 

3. A statement contains an invalid address 
expression: 

In cases where an absolute address 
expression is required, specifying a global 
symbol, a relocatable value, or a complex 
relocatable value (see Section 3.9) results 
in an invalid address expression. 

If an undefined symbol is made a default 
global reference by the .ENABL GBL 
directive (see Section 6.2.1) during passl, 
any attempt to redefine the symbol during 
pass 2 will result in an invalid address 
expression. 


•* 


* 
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Jo 


fi 


Error Code 


Meaning 


A (cont.) 


B 


D 

E 


In cases where a relocatable address 
expression is required, either a 
relocatable or absolute value is 
permissible, but a global symbol or a 
complex relocatable value in the statement 
results in an invalid address expression. 

For examples 

•BLKB/.BLKW/.REPT -- Other than an absolute 
value or an expression which reduces to an 
absolute value has been specified with the 
directive. 

4. Multiple expressions are not separated by a 
comma. This condition causes the next 
symbol to be evaluated as part of the 
current expression. 

5. .SAVE — The stack is full when the .SAVE 
directive is issued. 

6 . .RESTORE The stack is empty when the 
•RESTORE directive is issued. 

CATEGORY 5: ILLEGAL FORWARD REFERENCE. 

This type of error results from either of two 

possible conditions: 


^ global assignment statement 

(symbol==expression or symbol==:expres¬ 
sion) contains a forward reference to 
another symbol. 

2. An expression defining the value of the 
current location counter contains a forward 
reference. 


Bounding error. Instructions or word data are 
being assembled at an odd address. The location 
counter is incremented by 1. 

Doubly-defined symbol referenced. Reference was 
made to a symbol which is defined more than once. 

End directive not found. When the end-of-file is 
reached during source input and the .END directive 
has not yet been encountered, MACRO-11 generates 
this error code, ends assembly pajss 1, and 
proceeds with assembly pass 2. Also " caused by 
assembler-stack overflow. In this case MACRO-11 
will place a question mark (?) into the line at 
the point where the overflow occurred. 
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Error Code 

Meaning 

I 

Illegal character detected. Illegal characters 
which are also non-printable are replaced by a 
question mark (?) on the listing. The character 
is then ignored. 

L 

Input line is greater than 132(10) characters in 
length. Currently, this error condition is caused 
only during macro expansion when longer real 
arguments, replacing the dummy arguments, cause a 
line to exceed 132(10) characters. 

M 

Multiple definition of a label. A label was 
encountered which was equivalent (in the first six 
characters) to a label previously encountered. 

N 

A number contains a digit that is not in the 
current program radix. The number is evaluated as 
a decimal value. 

0 

Opcode error. Directive out of context. 
Permissible nesting level depth for conditional 
assemblies has been exceeded. Attempt to expand a 
macro which was unidentified after .MCALL search. 

P 

Phase error. A label's definition of value varies 
from one assembly pass to another or a multiple 
definition of a local symbol has occurred within a 
local symbol block. Also, when in a local symbol 
block defined by the .ENABL LSB directive, an 
attempt has occurred to define a local symbol in a 
program section other than that which was in 
effect when the block was entered. An error code 
P also appears if an .ERROR directive is 
assembled. 

Q 

Questionable syntax. Argument's are missing, too 
many arguments are specified, or the instruction 
scan was not completed. 

R 

Register-type error. An invalid use of or 

reference to a register has been made, or an 
attempt has been made to redefine a standard 
register symbol without first issuing the .DSABL 
REG directive. 

T 

Truncation error. A number generated more than 16 
bits in a word, or an expression generated more 
than 8 significant bits during the use of the 
.BYTE directive or trap (EMT or TRAP) instruction. 


J 

0 
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Error Code Meaning 


Undefined symbol. An undefined symbol was 
encountered during the evaluation of an 
expression; such an undefined symbol is assigned 
a value of zero. Other possible conditions which 
result in this error code include unsatisfied 
macro names in the list of .MCALL arguments and a 
direct assigment (symbol=expression or 
symbol=:expression) statement which contains a 
forward reference to a symbol whose definition 
also contains a forward reference; also, a local 
symbol may have been referenced that does not 
exist in the current local symbol block. 

Instruction error. The instruction so flagged is 
not compatible among all members of the PDP-11 
family. See Section 5.3 for details. 
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SAMPLE CODING STANDARD 




Local user requirements must be met in a coding standard, but 

1S as closely as possible helps you and DIGITAL bv 

simplifying communication and software ma *» - --- • y 

this is a samole anH _ 


E.l LINE FORMAT 


following format: 


2 . 


- L -“ f * * 

should be coded in uppercase only. 
Operation field - begins in column 


) your 

system. 



s in 

length 

with 

the 

column 

1 . 

This 

field 

(tab 

stop 

1 ) • 

This 


3. Operand field - begins in column 17 (tab stop 2). 
should be coded in uppercase only. 


This field 


Comment field - begins in column 33 (tab stop 4). if the 
operand field extends beyond column 33 (tab stop 4) leave a 
space and start the comment. This field should be coded in 
uppercase and lowercase to increase readability. 


E.2 COMMENTS 


To make the program easier to understand, comments should be used to 
explain the logic behind the instructions. In general this will 
consist of a comment per line of code. However, if a particularly 
difficult or obscure section of code is used, precede that section 
with a longer explanation. 

Comments that are too long for the comment field may be continued on 
following line* Begin the new line with a semicolon, space over 
to the column the comment began in and continue writing. All comments 
should be written in uppercase and lowercase to increase readability. 
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If a lengthy text is needed for an explanation, begin the comment with 
a line containing only the characters ;+ and end it with a line 
containing only the characters The lines between these delimiters 
should each begin with a semicolon and a space. For example: 


The invert routine accepts 
a list of random numbers and 
applies the Kolmogorov Algorithm 
to alphabetize them. 


E . 3 NAMING STANDARDS 
E.3.1 Registers 

E.3.1.1 General Purpose Registers - Use the default name: 


R0=%0 

REG 0 

R1 = %1 

REG 1 

R2 = %2 

REG 2 

R3=%3 

REG 3 

R4=%4 

REG 4 

R5=%5 

REG 5 

SP=%6 

Stack pointer (REG 6) 

PC = %7 

Program counter (REG 7) 


NOTE 

These register names are defined within 
the assembler; other standard symbols 
must be put in a file and linked with 
the program. 


E.3.1.2 Hardware Registers - Use the hardware definition, 
example, PS (Program Status Register) and SWR (Switch Register). 


E.3.1.3 Device Registers - Use the hardware notation. For example, 
the control status register for the RK disk is RKCS. 


E.3.2 Processor Priority 

Testing or altering the processor priority is done using the symbols 
PR0, PR1 1 PR2 , .PR7 

which are equated to their corresponding priority bit pattern. 
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<0 

L 

f 

!* 

I 


E.3.3 Symbols* 


The following 
names: 

chart 

diag rams 

the syntax of 

the 5 major types 

of symbol 

symbol 

pos-l 

pos-2 

pos-3 

pos-4 

pos-5 

pos-6 

length 

non-global 

symbol 

letter 

a-num/ 

null 

a-num/ 

null 

a-num/ 

null 

a-num/ 

null 

a-num/ 

null 

> = 1 

global 

symbol 

$/. 

*** 

a-num 

null 

a-num/ 

null 

a-num/ 

null 

a-num/ 

null 

a-num/ 

null 

> = 1 

global 

offset 

letter 

$/. 

*** 

a-num 

a-num/ 

null 

a-num/ 

null 

a-num/ 

null 

>=3 

global bit 
pattern 

letter 

a-num 

$/. 

* * ** *** * 

a-num/ 

a-num/ 

null 

a-num/ 

null 

> = 4 

local 

symbol 

number 

** 

$ 





>=2 


where: a-num is an alphanumeric character. 


E.3.3.1 Symbol Examples 

Non-Global Symbols 
A1B 
ZXCJ1 
INSRT 

Global Address Symbols 
$ JIM 
.VECTR 
$SEC 

Global Absolute Offset Symbols 
A$JIM 
A$XT 
A. ENT 


* Symbols that are branch targets are also called labels, but we will 
always use the term "symbol”. 

** Number is in the range 0<number<65535. 

*** The use of $ or . for global names is reserved for DEC-supplied 
software. 
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Global Bit Pattern Symbols 
A1 $20 
B3.6 
JI.M 

Local Symbols 
37$ 

271$ 

6 $ 


E.3.3.2 Local Symbols - Target symbols for branches that exist solely 
for positional reference will use local symbols of the form 

<num>$: 

Local symbols are formatted such that the numbers proceed sequentially 
down the page and from page to page. 


E.3.3.3 Global Symbols - Use of global symbols is restricted, within 
reason, to those cases where reference to the code occurs external to 
the code. 

A program never contains a .GLOBL statement without showing cause. 


E.3.3.4 Macro Names - In a macro name the last two characters (last 
character possibly being null) have special significance; the next to 
last character is a $, the last character specifies the mode of the 
macro. 

For example, in the three macro forms in-line, stack, and p-section, 
the in-line form has no suffix, the stack has an <S> suffix, and the 
p-section a <C>. Thus the Queue I/O macro can be written as any of 

QIO$ 

QIO$S 

QIO$C 

depending on the form required. These are not reserved letters. 


E.3.3.5 General Symbols - Make frequently used bit patterns such as 
carriage return (CR) and line feed (LF) conventional symbols as they 
are needed. 
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E.4 PROGRAM MODULES 

There are no limits on program size. However, since the virtual 

memory capacity of a computer is finite keep programs as compact as 
possible by: 

1 . creating them for a single function 

2 . writing them in accordance with the memory allocation 

guidelines in Appendix F. 

Code areas are different than data areas. Code is read-only but data 
can be read-only or read-write; read-only data should be segregated 
from read-write data. Both areas, code and data, should have 

explanatory comments. 



E.4.1 The Module Preface 

Put each program module in a separate file. For easy reference the 
file name should be similar to the name of the module. The file type 
is of the form 'NNN' where 'NNN' is the edit or the version number 
(see Section E.8). The availability of File Control Services and File 
Control Primitives will greatly simplify version number maintenance. 





I 


E.4.2 The Module 

Below is a list of the information that is included in the example 

MACRO-11 module (see Section E.4.3). 

The information is formatted as follows: 

1. The first six items appear on the same page and do not have 
explicit headings. 

2. A .NLIST statement, followed by any .ENABL/.DSABL or 
.NLIST/.LIST options that are relevant to the assembly of 
this module, followed by a matching .LIST statement. The 
.NLIST statement has a comment appended to it specifying the 
module edit level. 

3. A .TITLE statement that specifies the name of the module. If 
a module contains more than one routine, .SBTTL statements 
are used. 

4. Several .SBTTL statements giving the name, general function, 
and version number of the module. The .SBTTL directive 
inserts this information in the table of contents for guick 
reference. 

5. An .IDENT statement that specifies the version number of the 
module (see Section E.8). 

6 . A copyright statement, and a disclaimer, followed by a form 
feed. Note that the copyright, even though a comment, should 
be all uppercase. This insures that the copyright will be 
presented correctly, even on a terminal that only has 
uppercase. 
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7. 

8 . 
9. 

10 . 

11 . 

12 . 


The name of the facility, that the module is a part of. 
The name of the author. 


The date of module creation. 

A one or two line abstract of 

A description of all external 
one per line, in alphabetical 

A chronological edit trail of 
that includes the following: 


the function(s) of the module. 

references made by the module, 
order. 

modifications to the module 


• Edit number 

• Editor’s identification 

• Edit date 

• Description of the modification made 


NOTE 

Items 6 through 12 should appear on the 
same page. 


13. Any references to external files, using the .LIBRARY and 
.INCLUDE directives. 

14. .MCALL's to any externally defined macros. 

15. A list of the definitions of all equated symbols used in the 
module. These definitions should appear one per line and in 
alphabetical order. 

16. All local macro definitions, preferably in alphabetical 
order. 

17. All local data. The comments in this section should include: 

• Description of each element (type, size, and so forth) 

• Organization (functional, alphabetical, adjacent, and so 
forth) 

• Adjacency requirements (if any) 

18. A form feed, followed by an .SBTTL statement describing the 
routine that follows. 

19. A routine header, giving the following information: 

• Routine name 

• Description 

• Inputs 

• Calling sequence 

• Outputs 

• Side effects, register usage, and so forth 


NOTE 

Items 18 and 19 are repeated for every 
routine within the module. 
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E.4.3 Module Example 

•NLIST 
.ENABL GBL 
•LIST MEB 
.LIST 

.TITLE MACINI - Once-only code for the MACRO-11 assembler 
.SBTTL MACINI - Once-only code for the MACRO-11 assembler 
.SBTTL 

.SBTTL .IDENT /Y05.01/ 

.SBTTL 

.IDENT /Y 05.01/ 


COPYRIGHT (c) 1982, 1983 * 

BY DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS. * 

ALL RIGHTS RESERVED. * 

* 

THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED * 
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE * 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER * 
COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY * 
OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY * 

TRANSFERRED. * 

* 

THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE * 
AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT * 
CORPORATION. * 

* 


* DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS * 

* SOFTWARE ON EQUIPMENT THAT IS NOT SUPPLIED BY DIGITAL. * 

* * 
************************************************************************** 

<FF> 

++ 

Facility: MACRO-11 The PDP-11 macro assembler for RT/RSX/VMS and RSTS/E 


Author: 


Joe Worrail 


Created: 21-Aug-82 

Abstract: MACINI contains code only executed once per task invocation. 

Externals Description 


$LIBID File-ID of the system library account (LB: [1,1]) 
$POSID File-ID of the P/OS library account (LB: [1,5]) 
$STABF Workfile statistics buffer 


Edit 

Who 

Date 

Description of modification 

001 

Jrw 

25-Aug-82 

Handle P/OS .PARSE module. 

002 

Jrw 

05-Sep-82 

Allow recursive FINIT$'s. 

003 

J rw 

10-Nov-82 

Setup statistics buffer. 


<FF> 

; External file references 


•LIBRARY /MACLIB/ ;Add MACLIB.MLB to macro library list 

.INCLUDE /MACPRE/ /Include MACPRE.MAC in assembly 
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External library "•MCALL's" for this module 
.MCALL FINIT$ 

Equated symbols 

... Equated symbols ... 

Local macros 

... Local macros ... 


Local data 

... Local data ... 

<FF> 

.SBTTL $INIT - Handle once only code for MACRO-11 assembler 


$ INIT 

This routine is a collection of all the code, only executed 
once in any one run of the MACRO-11 task. It's collected 
here because: 

o It's logical to keep it in one place 

0 it keeps the code out of the root, keeping 

the assembler SMALL. 

INPUTS: n/a 

CALL: CALL $INIT 

OUTPUTS: 

Record management, statistics, and FCS buffers 
are setup. If the system contains EIS support, 
the DIV and MUL routine vectors are setup to 
point to the hardware instructions. 

EFFECTS: R0 - R5 Destroyed! 


... Begin module code ... 


E.4.4 Modularity 

No other characteristic has more impact on the ultimate engineering 
success of a system than does modularity. Adherence to a set of call 
and return conventions helps achieve this modularity. 
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E.4.4.1 Calling Conventions (Inter-Module/Intra-Module) 

Transfer of Control 

Macros exist for call and return. The actual transfer is via a 
JSR PC instruction. For register save routines, a JSR RN,SAVE is 
permitted. 

The CALL macro is: 

CALL subr-name 

The RETURN macro is: 

RETURN 

Register Conventions 

On entry, a subroutine minimally saves all registers it intends 
to alter except result registers. On exit it restores these 
registers. (The preservation of the register state is assumed 
across calls.) 

Argument Passing 

Any registers may be used, but their use should follow a coherent 
pattern. For example, if passing three arguments, use R0, R1 and 
R2 rather than R0, R2, R5. Saving and restoring occurs in one 
place. 


E.4.4.2 Exiting - All subroutine exits occur through a single RETURN 
macro. 



E.4.4.3 Success/Failure Indication - The 
success/failure indicator, where success 
1. The argument registers can be used to 
success/failure data. 


C bit is used 
equals 0, and 
return values 


to return the 
failure equals 
or additional 


E.4.4.4 Module Checking Routines - Modules are responsible for 
verifying the validity of arguments passed to them. The design of a 
module's calling sequence should aim at minimizing the validity checks 
by minimizing invalid combinations. Programmers may add test code to 
perform additional checks during checkout. All code should aim at 
discovering an error as close (in terms of instruction executions) to 
its occurrence as possible. 
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E.5 CODE FORMAT 
E.5.1 Program Flow 

Programs are organized on the listing so that they flow down the page, 
even at the cost of an extra branch or jump. All unconditional branch 
and jump instructions should be followed by a blank line. This causes 
these instructions to stand out in the source code, allowing the code 
to be traced more easily. 

For example: 






appears on the listing as: 
TST 

BNE BBB 

AAA: .... «... 


BR 


CMN 


BBB: 



CMN: 



I 
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rather than: 

TST 

BNE BBB 

AAA: .... 


CMN: 


BBB: 


BR CMN 


E.5.2 Common Exits 

A common exit appears as the last code sequence on the listing, 
the flow chart: 



appears on the listing as: 

PR 1 • 

1 • .... ...a 


PR2: 


PR3: 


BR EXIT 


BR EXIT 


PR4: 


BR EXIT 


Thus 
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EXIT: 

and not as: 
PR1: 

EXIT: 

PR2 : 


PR3 : 


PR4: 


BR 


BR 


EXIT 


EXIT 


BR 


EXIT 


E.5.3 Code with Interrupts Inhibited 

Code that is executed with interrupts inhibited, is flagged by a three 
semicolon (;;;) comment delimiter. For example: 


,ERTZ : 


10 $: 


BIS 

BIT 

BEQ 

RTT 


#PR7 f PS 
#PR7,2(S P) 
10 $ 


/Enable by returning 
;by system subroutines, 


inhibit interrupts 
c 

o 

m 

m 

e 

n 

t 

s 


E.5.4 Code in System State 

RSX-11M executive subroutines and other privileged code that is 
executed in system state is flagged by a two semicolon (;?) comment 
delimiter. For example: 

Switch to system state, ... 
and exit. 
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jo 

EXIT 

E. 6 
E.6.: 

p 

p 


P 

■ 


CALL $SWSTK,EXIT 


Inhibit context switching 
Return in system state 


RETURN 


;; Go back to user state (EXIT) 
; User state code 


INSTRUCTION USAGE 

Forbidden Instructions 


1. The use of instructions or index words as literals of the 
previous instruction. For example: 

MOV @PC,REGISTER 

BIC SRC,DST 

uses the bit clear instruction as a literal. This may seem 
to be a very "neat" way to save a word but what about 
maintaining a program using this trick? To compound the 
problem, it will not execute properly if I/D space is enabled 
on the 11/45. In this case @PC is a D bank reference. 

2. The use of the MOV instruction instead of a JMP instruction 
to transfer program control to another location. For 
example: 

MOV #ALPHA,PC 

transfers control to location ALPHA. Besides taking longer 
to execute (2.3 microseconds for MOV vs. 1.2 for JMP) the 
use of MOV instead of JMP makes it nearly impossible to pick 
up someone else's program and tell where transfers of control 
take place. What if one would like to get a jump trace of 
the execution of a program (a move trace is unheard of)? As 
a more general issue, other operations such as ADD and SUB 
from PC should be discouraged. 

3. The seemingly "neat" use of all single word instructions 
where one double-word instruction could be used and would 
execute faster and would not consume additional memory. 
Consider the following instruction sequence: 

CMP — (R1) ,-(Rl) 

CMP —(Rl),—(Rl) 

The intent of this instruction sequence is to subtract 8 from 
register Rl (not to set condition codes). This can be 
accomplished in approximately 1/3 the time via a SUB 
instruction (9.4 vs. 3.8 microseconds) at no additional cost 
in memory space. 

1. Self-relative address arithmetic (.+n) is absolutely 
forbidden in branch instructions; its use in other contexts 
must be avoided if at all possible and practical. 
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E.6.2 Conditional Branches 

When using the PDP-11 conditional branch instructions, it is 
imperative that the correct choice be made between the signed and the 
unsigned branches. 


SIGNED 

UNSIGNED 

BGE 

BHIS 

(BCC) 

BLT 

BLO 


BGT 

BHI 


BLE 

BLOS 

(BCS) 


A common pitfall is to use a signed branch (for example, BG T) when 
comparing two memory addresses. This works until the two addresses 
have opposite signs; that is, one of them goes across the 16K 
(100000(8)) bound. This type of coding error usually results from 
re-linking the program at different addresses and/or changing the size 
of the program. 


•j 


E.7 PROGRAM SOURCE FILES 

Source creation and maintenance is done in base levels. A base level 
is the point at which the program source files have been frozen. From 
the freeze point to the next base level, corrections are not made 
directly to the base level itself, rather a file of corrections is 
accumulated for each file in the base level. Whenever an updated 
source file is desired, the correction file is applied to the base 

file. 


The accumulation of corrections proceeds until a logical breaking 
point has occurred (a milestone or significant implementation point 
has been reached). At this time all accumulated corrections are 
applied to the previous base level to create a new base level and 
correction files are started for the new base level. 


E.8 PDP-11 VERSION NUMBER STANDARD 

The PDP-11 Version Number Standard applies to all modules, parameter 
files, complete programs, and libraries which are written as part of 
the PDP-11 Software Development effort. It is used to provide unique 
identification of all released, pre-released, and in-house software. 

The version number is limited in that only six characters of 

identification are used. Future implementations of the Macro 
Assembler, linker, and librarian should provide for at least nine 
characters, and possibly twelve. It is expected that this standard 
will be improved as the need arises. 

Version Identifier Format: 

<version> <edit> <patch> 

where: <version> consists of two decimal digits which 

represent the release number of a program. 
The version number starts at 00 and is 
incremented to reflect the number of major 
changes in the program. 
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<edit> 


<patch> 


consists of two decimal digits which 
represent the number of alterations made to 
the source program. The edit number begins 
at 01 (is null if there are no edits) and is 
incremented with each alteration. 


is a letter between B and Z which represents 
the number of alterations made to the binary 
form of the program. The patch number begins 
at B (is null if there are no patches) and 
changes alphabetically with each patch. 


These fields are interrelated. When <version> 
<patch> and <edit> must be reset to nulls. It is 
<edit> is incremented, then <patch> will be re-set 
the various bugs have been fixed. 


is changed, then 
intended that when 
to null, because 


E.8.1 Displaying the Version Identifier 

The visible output of the version identifier should appear as: 

Program 

Name <key-letter> <version> . <edit> <patch>, 
where the following Key Letters have been identified: 

X in-house experimental version 

Y field test, pre-release, or in-house release version 

V released or frozen version 

'X' corresponds roughly to individual support, 'Y* to group support, 
and 'V' to company support. 

The dot (.) which separates <version> from <edit> is not used if both 
<edit> and <patch> are null. When a version identifier is displayed 
as part of program identification, then the format is: 

Program 

Name <space><key-letter><version> . <edit><patch> 

Examples: 


PIP V05.00 
LINK V08.00 
MACRO V05.00 


E.8.2 Use of the Version Number in the Program 


All sources 
In programs 
module must 
or library 
constituent 
the first 
SIN routine. 


must contain the version number in an .IDENT directive, 
(or libraries) which consist of more than one module, each 
have a version number. The version number of the program 
is not necessarily related to the version numbers of the 
modules; it is perfectly reasonable, for example, that 
version of a new FORTRAN library, V00, contain an existinq 
say V05.01. 
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Parameter files are also required to contain the version number in an 
.IDENT directive. Because the assembler records the last .IDENT seen, 
parameter files must precede the program. 

Entities which consist of a collection of modules or programs. (fo r 
example, the FORTRAN Library) have an identification module in the 
first position. An identification module exists solely to provide 
identification. For example: 

;OTS identification 
.TITLE FTNLIB 
.IDENT /V02.00/ 

.END 

is an identification module. 
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ALLOCATING VIRTUAL MEMORY 




This appendix is intended for the MACRO-11 user who wants to avoid the 
problem of thrashing, by optimizing the allocation of virtual memory. 
Users of smaller systems should become thoroughly familiar with the 

conventions discussed herein. This appendix discusses the followinq 
topics: ^ 

1. General hints and space-saving guidelines 

2. Macro definitions and expansions 

3. Operational techniques. 

The user is assumed to have pursued a policy of modular programming, 
as advised in Appendix E. Modular programming results in bodies of 
code that are small, distinct and highly functional. Using such code, 
which presents many advantages, one can usually avoid the problem of 
insufficient dynamic memory during assembly. 


p 


F.l GENERAL HINTS AND SPACE-SAVING GUIDELINES 

Work-file memory is shared by a number of MACRO-11's tables, each of 
which is allocated space on demand (64K words of dynamically pageable 
storage are available to the assembler). The tables and their 
corresponding entry sizes are as follows: 

1. User—defined symbols — five words. 

2. Local symbols - three words. 

3. Program sections - six words. 

4. Macro names - five words. 

5. Macro text - nine words. 

6. Source files - six words. 

In addition, several scratch pad tables are used during the assembly 
process, as follows: 

1. Expression analysis - five words. 

2. Object code generation - five words. 
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3. Macro argument processing - three words. 

4. .MCALL argument processing - five words. 

The above information can serve as a guide for estimating dynamic 
storage requirements and for determining ways to reduce such 
requirements. 

For example, the use of local symbols whenever possible is highly 
encouraged, since their internal representation requires 25 percent 
less dynamic storage than that required for regular user-defined 

symbols. The usage of local symbols can often be maximized by 

extending the scope of local symbol blocks through the .ENABL 

LSB/.DSABL LSB MACRO-11 directives see Sections 3.5 and 6.2.1). 

Since MACRO-11 does not support a purge function, once a symbol. is 
defined, it permanently occupies its. dynamic memory allocation. 
Numerous instances occur during conditional assemblies and repeat 
loops when a temporarily assigned symbol is used as a count or offset 
indicator. If possible, the symbols so used should be re—used. 

In keeping with the same principle, special treatment should be given 
to the definition of commonly used symbols. Instead of simply 
appending a prefix file which defines all possibly used symbols 
each assembly, users are encouraged to group symbols into logical 
classes. Each class can then become a shortened prefix file or. a 
macro in a library (see Section F.2 below). In either case, selective 
definition of symbolic assignments is achieved, resulting in fewer 
defined (but unreferenced) symbols. 

An example of this idea is seen in the definition of IAS/RSX-11M 
standard symbols. The RSX system macro library, for example, supplies 
several macros used to define distinct classes of symbols. These 
groupings and associated macro names are as follows: 

DRERR$ - Directive return status codes 

FILIO$ - File-related I/O function codes 

IOERR$ - I/O return status codes 

SPCIO$ - Special I/O function codes 


F.2 MACRO DEFINITIONS AND EXPANSIONS 

Dynamic storage is used most heavily for the storage of macro text. 
Upon macro definition or the issuance of an .MCALL directive, the 
entire macro body is stored, including all comments appearing in the 
macro definition. For this reason, comments should not be included as 
part of the macro text. A librarian function switch (/SZ) is 
available to compress macro source text by removing all trailing 
blanks and tabs, blank lines, and comments. The system macro library 
(RSXMAC.SML) has already been compressed. User-supplied macro 
libraries (.MLB) and macro definition prefix files should also be 
compressed. For additional information regarding these.two utility 
tasks, consult the applicable RSX-11M or RSX-11M-PLUS Utilities Manual 
(see Section 0.3 in the Preface). 


«p 
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It often seems practical to inc 
definitions in each assembly, 
undesirable allocation of valua 
macros. This waste of memo 
macro definitions a user-suppli 
This means that the names 
arguments in the .MCALL directi 
MACRO call, .ENABL MCL, must be 


lude a file of commonly used macro 
This practice, however, may produce the 
ble dynamic storage for unnecessary 
ry can be avoided by making the file of 
ed macro library file (see Table 8-1). 
of desired macros must be listed as 
ve (see Section 7.8), or the automatic 
enabled (see Section 6.2.1). 


Certain types of macros can be redefined to null after they have been 
invoked. This practice not only frees storage space, it also 
eliminates the overhead and the dynamic memory wasted by calling a 


useless 


. . by caning 

. . macro. The practice of redefining macros to null applies 

mainly to those that define symbolic assignments, as shown 
example below. The redefinition process may be 

follows: 


in the 
accomplished as 


.MACRO DEFIN 
SYM1 = VAL1 
SYM2 = VAL2 


;Define symbolic assignments. 


0FF1 - SYMBOL ;Define symbolic offsets. 

0FF2 = 0FF1+SIZ1 
0FF3 = OFF2+SIZ2 


OFFN 


OFFM+SIZM 



•MACRO DEFIN ;Macro null redefinition. 

. ENDM 


•ENDM DEFIN 

Macros exhibiting this redefinition 
read via the .MCALL directive) 
definition and/or .MCALL processing 
efficient use of dynamic memory. 


property should be defined (or 
and invoked before all other macro 
a practice that ensures more 


F.3 OPERATIONAL TECHNIQUES 

When, despite adhering to the guidelines discussed above, performance 
still falls below expectations, several additional measures may be 
taken to increase dynamic memory. 


( 


p 

I 
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The first measure involves shifting the burden of symbol definition 
from MACRO-11 to the linker or task builder. In most cases, the 
definition of system I/O and File Control Services (FCS) symbols (and 
user-defined symbols of the same nature) is not necessary during the 
assembly process, since such symbols are defaulted to global 
references (Appendix D.l, category 4 of error code A). The linker or 
task builder attempts to resolve all global references from 
user-specified default libraries and/or the system object.1ibrary 
(SYSLIB). Furthermore, by applying the selective search, option for 
object modules consisting only of global symbol definitions, the 
actual additional burden to the linker is minimal. 


The second way is to produce only one output file 
listing), as opposed to two. The additional 
support the second output file is allocated from 
memory at the start of each assembly. 


(either object or 
memory required to 
available dynamic 
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G.l INTRODUCTION TO POSITION-INDEPENDENT CODE 

The outiput: of a MACRO-11 assembly is a relocatable object module. The 
ask Builder or Linker binds one or more modules together to create an 
executable task image. Once created, if the program is to run it must 
be loaded at the virtual address specified at link time. This is 
because the Task Builder or Linker has to modify some instructions to 
reflect the memory locations in which the program is to run. Such a 
body of code is considered position-dependent (dependent on the 
virtual addresses to which it is bound). 

All PDP-11 processors offer addressing modes that make it possible to 
write code that does not depend on the virtual addresses to which it 
is bound. Such code is termed position-independent and to run can be 
loaded at any virtual address. Posit ion-independent code can improve 
system efficiency, both in use of virtual address space and in 
conservation of physical memory. 

In multiprogramming systems like IAS, RSX-11M and RSX-11M-PLUS, it is 
important that many tasks be able to share a single physical copy of 
common code, for example, a library routine. To make the optimum use 
of a task's virtual address space, shared code should be 
position-independent. Position-dependent code can also be shared, but 
it must appear in the same virtual locations in every task using it. 
This restricts the placement of such code by the Task Builder or 
Linker and can result in the loss of virtual addressing space. 

The construction of position-independent code is closely linked to the 
proper usage of PDP-11 addressing modes. The remainder of this 
Appendix assumes you are familiar with the addressing modes described 
in Chapter 5. 

All addressing modes involving only register references are 
position-independent. These modes are as follows: 

R register mode 

(R) register deferred mode 

(R)+ autoincrement mode 

@(R)+ autoincrement deferred mode 

-(R) autodecrement mode 

@-(R) autodecrement deferred mode 

When using these addressing modes, you are guaranteed 

position-independence, provided the contents of the registers have 
been supplied such that they are not dependent upon a particular 
virtual memory location. 
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The relative addressing modes are position-independent when a 
relocatable address is referenced from a relocatable instruction. 
These modes are as follows: 

A relative mode 

@A relative deferred mode 

Relative modes are not posit ion-independent when an absolute address 
(that is a non-relocatable address) is referenced from a relocatable 
instruction. In this case, absolute addressing (@#A) may be used to 
make the reference posit ion-independent. 

Index modes can be either posit ion-independent or position-dependent, 
according to their use in the program. These modes are as follows: 

X(R) index mode 

@X(R) index deferred mode 

If the base, X, is an absolute value (for example, a control block 
offset), the reference is position-independent. For example: 

MOV 2(S P) ,R0 ;Posit ion-independent 

N=4 

MOV N(S P) ,R0 ;Position-independent 

If, however, X is a relocatable address, the reference is 

position-dependent. For example: 

CLR ADDR(Rl) ;Position-dependent 

Immediate mode can be either position-independent or not, according to 
its usage. Immediate mode references are formatted as follows: 

#N immediate mode 

When an absolute expression defines the value of N, the code is 
position-independent. When a relocatable expression defines N, the 
code is position-dependent. That is, immediate mode references are 
posit ion-independent only when N is an absolute value. 

Absolute mode addressing is position-independent only in those cases 
where an absolute virtual location is being referenced. Absolute mode 
addressing references are formatted as follows: 

@#A absolute mode 

An example of a position-independent absolute reference is a reference 
to the directive status word ($DSW) from a relocatable instruction. 
For example: 

MOV @#$DSW,R0 ;Retrieve directive status 


G.2 EXAMPLES 

The RSX-11M library routine, PWRUP, is a FORTRAN callable subroutine 
that establishes or removes a user power failure Asynchronous System 
Trap (AST) entry point address. Imbedded within the routine is the 
AST entry point that saves all registers, effects a call to the 
user-specified entry point, restores all registers on return, and 
executes an AST exit directive. The following examples are excerpts 
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k> 

I 

I 

I 

I 

V 

I 

I 

p 

I 

I 

p 

I 

I 

I 

I 


from this routine. The first example. Figure G-l has been modified to 
illustrate position-dependent references. The second example, Figure 
G-2 f is the position-independent version. 

{ + 

? Position dependent code example 
»- 


pwrup:: clr 


-<SP) 


{Assume success 


i Perform further initialization*» 



MOV 

$0TSV f R4 


MOV 

( SP ) + f R2 


BNE 

10$ 


CLR 

-<SP) 


BR 

20$ 

io$: 

MOV 

R2 f F . PF ( R4 ) 


MOV 

♦BAf-(SP) 

20 $: 

{ Continue processing*•• 

{ + 

{ AST 

? - 

service 

routine 

ba: 

MOV 

R0.-<SP) 


{Point R4 at object time system save area 
r the above reference to $OTSV is position- 
» dependent 

{Retrieve AST entry point address 

fBranch if one was specified 

?If noneF specify no power fail routine 

fB ypass AST setup 

fSet the AST entry point 

{Push our AST service address 

f the above reference to BA is position- 

f dependent 


{Preserve RO 


f Rest of routine follows*** 


Figure G-l Example of Position-Dependent Code 


F + 

f Position independent code example 

F ~ 

PWRUPt: CLR -(SP) {Assume success 

f Perform necessary initialization*.* 


MOV 

0*$OTSVfR4 

MOV 

( SP ) + f R2 

BNE 

10$ 

CLR 

-(SP) 

BR 

20$ 

MOV 

R2 f F ♦ PF ( R4 ) 

MOV 

PCf-(SP) 

ADD 

♦BA-* f (SP) 


10 $: 


20$ J 

f Continue processing««• 

{ + 

f AST service routine 

F~ 

ba: mov rof-(sp) 

f Rest of routine follows* •» 


{Point R4 at object time system save area 
{ the above reference to tOTSV is position- 
{ independent 

{Retrieve AST entry point address 

{Branch if one was specified 

{If none* specify no power fail routine 

{Bypass AST setup 

{Set the AST entry point 

{Push our PC to relocate our AST service addr 
{Relocate our AST service address now 
{ the above reference to BA is position- 
f independent* this costs one word to relocate 


{Preserve RO 


Figure G-2 Example of Position-Independent Code 
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The position-dependent version of the subroutine contains a relative 
reference to an absolute symbol ($OTSV) and a literal reference to a 
relocatable symbol (BA). Both references are bound by the Task 
Builder to fixed memory locations. Therefore, the routine will not 
execute properly as part of a resident library if. its location in 
virtual memory is not the same as the location specified at link time. 

In the position-independent version, the reference to $OTSV has been 
changed to an absolute reference. In addition, the necessary code has 
been added to compute the virtual location of BA based upon the value 
of the program counter. In this case, the value is obtained by adding 
the value of the program counter to the fixed displacement between the 
current location and the specified symbol. Thus, execution.of the 
modified routine is not affected by its location in the image s 
virtual address space. 

The MACRO-11 Assembler provides a way of checking whether the code is 
position-independent. In an assembly listing, MACRO-11 inserts a 
character following the contents of any word which requires the Task 
Builder or Linker to perform a relocation operation and, therefore, 
may not be position independent code. The cases which cause an 
apostrophe to be inserted in the assembly listing are as follows: 

1. Absolute mode references when the reference is relocatable. 
References are not flagged when they are absolute. For 
example: 

MOV @#ADDR,R1 ;Pic only if ADDR is absolute. 

2. Index and index deferred mode references when the offset is 
relocatable. For example: 

MOV ADDR(R1),R5 ;Non-pic if ADDR is relocatable. 

MOV @ADDR(R1),R5 ;Non-pic if ADDR is relocatable. 

3. Relative and relative deferred mode references when the 
address specified is relocatable with respect to another 
program section. For example: 

MOV ADDR1,R1 ;Non-pic when ADDR1 is absolute. 

MOV @ADDR1,R1 

4. Immediate mode references to relocatable addresses. 

MOV #ADDR,R1 ;Non-pic when ADDR is relocatable. 

In one case, MACRO-11 does not flag a potential position-dependent 
reference. This occurs where a relative reference is made to an 
absolute virtual location from a relocatable instruction (see the MOV 
$0TSV,R4 instruction in Figure G-l). 

References requiring more than simple relocation at link time are 
indicated in the assembly listing. Simple global references are 
flagged with the letter G. Statements which contain multiple global 
references or require complex relocation, are flagged with the letter 
C (see Section 3.9 and Chapter 4). It is difficult to positively 
state whether or not a C—flagged statement is posit ion—independent• 
However, in general, position dependence can be decided by applying 
the guidelines discussed earlier in this Appendix to the resulting 
address value produced at link time. 
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APPENDIX H 

SAMPLE ASSEMBLY AND CROSS REFERENCE LISTING 


>R50UNP MACRO V05.00 Saturday 08-Jan-83 11147 
TABLE OF CONTENTS 

2- 1 RAD50 unpack routine 


R30UNP MACRO VOS.00 Saturday 08-Jan-83 ll!47 Paae 1 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 


♦TITLE R50UNP 
♦ IDENT /02/ 


* 


COPYRIGHT (c) 1979 BY 

DIGITAL EQUIPMENT CORPORATION* MAYNARD* MASS. 


t THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED 

* ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE 

* INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER 

* COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY 

* OTHER PERSON, NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY 
TRANSFERRED, 


THE INFORMATION IN THIS SOFTWARE 
AND SHOULD NOT BE CONSTRUED 
CORPORATION, 


IS SUBJECT TO CHANGE WITHOUT NOTICE 
AS A COMMITMENT BY DIGITAL EQUIPMENT 


DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS 
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. 

UPDATE HISTORY: 

D.N. CUTLER 10-FEB-73 
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SAMPLE ASSEMBLY AND CROSS REFERENCE LISTING 


R30UNP MACRO M03.00 Saturday 08-Jan-B3 li:47 Paae 2 
RAD50 UNPACK ROUTINE 


3 

4 

5 

6 

7 

8 


.SBTTL RAD50 unpack routine 

f + 

i R50UNP „ A _ T 

Unpack a 6 char RAD50 symbol to ASCII 

Enter with R2 -> Output ASCII string 
SYMBOLr SYMBOL+2 = RAD50 symbol to unpack 


9 

10 



i Return with R2 -> Past outp 

11 



i R0, Rif R3 Destroyed 

12 



»- 


13 

14 

000000 


♦PSECT 

PUREI t I 

15 

16 

000000 

010446 

R50UNP::mov 

R4 f-(SP) 

17 

000002 

012704 

MOV 

♦ SYMBOL t R4 



OOOOOOG 



18 

000006 

012401 

i*: mov 

(R4)+»R1 

19 

000010 

012703 

MOV 

#50*50 f R3 



003100 



20 

000014 

004767 

CALL 

10* 



000030 



21 

000020 

012703 

MOV 

♦ 50 f R3 



000050 



22 

000024 

004767 

CALL 

10* 



000020 



23 

000030 

010100 

MOV 

R1»R0 

24 

000032 

004767 

CALL 

11* 



000016 



25 

000036 

020427 

CMP 

R4» #SYMBOL + 4 



000004G 



26 

000042 

001361 

BNE 

1* 

27 

000044 

012604 

MOV 

(SP) + t R4 

28 

000046 

000207 

RETURN 


29 

30 



f Divide RAD50 

word and convi 

31 





32 

000050 

005000 

io*: CLR 

RO 

33 

000052 

071003 

DIV 

R3f RO 

34 

35 



f Translate RAE 

i50 character 


iSave R4 

>Point at RAD50 symbol buffer 

f Get next RAD50 word 

JSet divisor for high character 

fU npack and store the character 

\Now set divisor for middle character 

JUnpack and store the character 

JCopy remaining character 
iTranslate and store it 

$ Test if last word done 

JBranch if no 
f Restore R4 
JReturn to caller 


36 

37 

38 

39 

40 

41 

42 

43 000054 

44 000056 

45 000060 

46 000064 

47 000066 

48 000070 


0 = space 
1-32 = A-Z 


005700 

001412 

020027 

000033 

002405 

001402 

062700 

000011 


f 33 = 

* 


f 34 = 

» 


f 35 = 

unused 

code 

f 36-47 

* 0-9 


u*: 

TST 

RO 


BEQ 

23* 


CMP 

ROf#33 


BLT 

22* 


BEQ 

21* 


ADD 

♦22-11?RO 


JTest if space 
fBranch if so 
»Test if middle 

fB ranch if alphabetic 
fBranch if dollar sign 
r Dot or digits 0-9 


R50UNP MACRO VOS.00 Saturday OB-Jan-83 11147 
RAD50 UNPACK ROUTINE 
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49 000074 

50 000100 

51 000104 

52 000110 

53 000112 

54 

55 


062700 

177711 

062700 

000040 

062700 

000040 

110022 

000207 

000001 


21 *: 
22 *: 

23*: 


ADD 

ADD 

ADD 

M0 VB 
RETURN 

♦ END 


#11-100 f R0 
* 100-40 »R0 
#40»R0 
R0 r (R2) + 


i Dollar 
}Alphabetic 
i Space 

f Store ASCII char in buffer 
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SAMPLE ASSEMBLY AND CROSS REFERENCE LISTING 


R50UNP 

MACRO 005, 

.00 Saturday 08-Jan-83 11!47 

Symbol 

Tab 1 e 

R50UNP 

OOOOOORG 

002 SYMBOL= ****** GX 

. ABS. 

000000 

000 


000000 

001 

PURE I 

000114 

002 


Errors detected! 0 

*** Assembler statistics 

Work file reads! 0 
WorK file writes! 0 

Size of work file! 7936 Words ( 1 Rases) 
Size of core pool! 16158 Words (72 Pases) 
Operatins system! RT-11 
Elapsed time! 00!00!04.34 
DK!R50UNP,DK!R50UNP/C=DK!SUM 


R50UNP MACRO 005.00 Saturday 08-Jan-83 11!47 Paae S~1 
Cross reference table (CREF 005.00) 


R50UNP 2-16# 

SYMBOL 2-17 2-25 


R50UNP MACRO 005.00 Saturday 08-Jan-83 11!47 Pase R-l 
Cross reference table (CREF VOS.00) 


RO 2-23* 

2-50* 
R1 2-18* 

R2 2-52* 

R3 2-IS* 

R4 2-16 

SP 2-16* 


2-32* 2-33* 

2-51* 2-52 

2-23 

2-21* 2-33 

2-17* 2-18 

2-27 


2-43 2-45 


2-25 2-27* 


2-48* 2-49* 


R50UNP MACRO 005.00 Saturday 08-Jan-83 11!47 Paae C-l 
Cross reference table (CREF 005.00) 


0-0 

. ABS. 0-0 
PUREI 2-14 
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APPENDIX I 


OBSOLETE MACRO-11 DIRECTIVES, SYNTAX, AND COMMAND LINE OPTIONS 


1.1 OBSOLETE DIRECTIVES AND SYNTAX 

The following directives and syntax, although supported in this 
release of the assembler, will NOT be supported in future assembler 
releases. The following table shows the old directives and syntax, 
and the new syntax to use. All MACRO-11 code that contains the old 
directives and syntax should be updated to use the new syntax. 


Table 1-1 

Old and New Directives and Syntax 


Syntax no longer supported New syntax to use 


. EOT 

•IFZ xxx or 
•IF Z,xxx 
•IFNZ xxx o 
.IF NZ f xxx 
.IFL xxx or 
.IF L,xxx 
.IFG xxx or 
.IF G , xxx 
•IFLE xxx 
.IFDF xxx 
•IFNDF xxx 


.IFEQ xxx 
.IFNE xxx 
.IFLT xxx 
.IFGT xxx 


None 

.IF EQ,xxx 
.IF EQ,xxx 
.IF NE, xxx 
.IF NE, xxx 
.IF LT f xxx 
•IF LT, xxx 
.IF GT,xxx 
.IF GT, xxx 
.IF LE,xxx 
.IF DF,xxx 
.IF NDF,xxx 


1.2 OBSOLETE COMMAND LINE OPTION 

The MACRO-11 command line option /P[ASS]:n is no longer supported by 
DIGITAL. This switch was originally created to speed up assemblies in 
some cases by only scanning a given file with one pass of the 
assembler. 

It has been found that the /P[ASS]:n switch has many side effects, and 
has caused more problems than can be documented reasonably. 

Although the syntax of the /P[ASS]:n switch is still allowed to appear 
on a MACRO-11 command line, no SPRs will be accepted relating to the 
switch. All documentation for the /P[ASS]:n switch has been removed. 

Any assembly command files containing the /P[ASS]:n switch should be 
updated by removing this switch. 
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APPENDIX J 


RELEASE NOTES 


This appendix explains the changes that have been made to MACRO-11 
since the last version release. The new features mentioned are fully 
documented in chapters one through nine of this manual. 


J.l CHANGES — ALL VERSIONS OF MACRO-11 


1. The opcode, CALLR addr (Call-Return), has been added to the 
permanent symbol table (PST). This opcode is equivalent to 
the JMP addr opcode. The CALLR addr opcode was added to 
complement the CALL addr opcode -- which is equivalent to the 
JSR PC,addr opcode. 


2. The previous version of MACRO-11 used a range of 64$ to 127$ 

for automatic local symbol generation. MACRO-11 now uses a 
range of 30000$ to 65535$ when generating local symbols. 

3. Most assembler generated listing text is now in 

upper/lowercase. This change was made to increase the 

readability of MACRO-11 code. Lines of code that include the 
•SBTTL or the .TITLE directive are not converted to 

uppercase. 


4. Lines of code that include the .SBTTL directive are listed in 
the table of contents of an assembly listing, even if a 
•NLIST statement is in effect at the time the .SBTTL lines 
are encountered. You may specify the .NLIST directive with 
the TOC argument to prevent the table of contents from being 
printed. 


5. 


The symbol table 
if the .NLIST 
.NLIST directive 
table from being 


is printed at the end of an assembly, even 
directive is in effect. You may specify the 
with the SYM argument to prevent the symbol 
printed. 


6. All page headers include the day of the week. 
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7. The assembler statistics information that appears at the end 
of the assembly listing file has been updated to include the 
following additional information: 


• 

Total number of virtual work file 

reads 



• 

Total number of virtual work file 

writes 



• 

Maximum amount of virtual memory 

used (in words 

and pages) 

• 

Size of physical memory freespace 

( in words 

and 

pages) 

• 

Operating system and environment 

that the 

assembler is 


running under 




• 

Total elapsed assembly time 




• 

MACRO-11 command line 





8. The PSECT synopsis that is printed in the listing file, after 
the symbol table, includes the psect attributes. 

9. The maximum number of relocatable terms in a complex 
expression has been changed. The maximum size of an .OBJ 
record that MACRO-11 can produce was increased from 42. bytes 
to 128. bytes. 

Do not compare .OBJ files that have been created by different 
versions of MACRO-11 when verifying whether your code 
generation is correct. Changes that have been made for this 
version of MACRO-11 (mentioned above) will invalidate a 
direct comparison of assembler .OBJ output. Verify code 
generation by linking or taskbuilding the .OBJ files involved 
and then comparing the .SAV or the .TSK image files. 


NOTE 

Because the .OBJ files produced by this new version 
of MACRO-11 are different, users of the PAT (object 
file patch utility) are warned that checksums must be 
recomputed on any object patches assembled with this 
new version of MACRO-11. 


10. The default for the LC argument has been changed from .DSABL 
LC to .ENABL LC. 

11. The following .ENABL/.DSABL options have been added: 

1. .ENABL LCM/.DSABL LCM 

2. .ENABL MCL/.DSABL MCL 

12. The following directives have been added to MACRO-11. These 
new directives are documented in this manual. 


1. 

.CROSS 

2. 

.INCLUDE 

3. 

.LIBRARY 

4. 

.MDELETE 

5. 

.NOCROSS 

6. 

.REM 

7. 

.WEAK 
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J.2 CHANGES — MACRO-ll/RSX VERSION ONLY 


1 . 


The 


cross-reference options SEC and ERR have 


been added. 


NOTE 


The RSX-11 CREF program (CRF) has been 
include support for these two 
cross-reference options. Only the new 
version (V2) distributed with RSX-11M 
RSX-11M-PLUS V2.1 should be used with this 
MACRO-11. 


updated to 
new macro 
RSX-11 CRF 
V4.1 and 
version of 


2. The default for the command line option /[-]SP has been 
modified from /SP to /-SP. The new default may be modified 
by the system manager using the TKB GBLPAT option described 
in the MACRO-ll/RSX task build command file. 


J•3 CHANGES — MACR0-11/RT-11 VERSION ONLY 

1. The message: 

Errors detected: 0 

has been removed. MACRO-11 prints this message on the 
terminal only if errors have been detected in the module 
being assembled. 

2. If the first character in a MACRO-11/RT-l1 command line is a 
semicolon (;), the line is treated as a comment and is 
ignored. This change was made to maintain compatibility with 
the RSX-11 version of MACRO-11. 

3. RSX-11 style command line switches may be used in addition to 
the one-character switches: 


/M 

may 

be represented 

as 

/M[LIB] 


/E 

may 

be represented 

as 

/E [NABL] 


/D 

may 

be represented 

as 

/D[SABL] 


/P 

may 

be represented 

as 

/P [ASS] 


/L 

may 

be represented 

as 

/L[I ST] 


/N 

may 

be represented 

as 

/N[LIST] 


The default file 

extension for 

macro 

libraries has 

been 

changed 

to .MLB ( 

, to conform with RSX- 

11. The RT-11 V5 

LIBR 

program 

extension 

defaults 
also. 

its macro library 

output to the 

.MLB 
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5. Prior to this release of MACRO-11, if you specified more than 

one .MLB file on a command line, and each file had a 
definition of the same macro, the first macro library 
specified would be used for the macro definition if called in 
the source program. This has been modified to work like the 
RSX-11 macro assembler. The RT-11 macro assembler now scans 
.MLB files from the last file specified (either in the 
MACRO-11 command line or by using the .LIBRARY directive) to 
the first file specified. The assembler then scans the 

system default macro library, SY: SYSMAC.SML. 

6. The default for the GBL argument has been changed from .DSABL 
GBL to .ENABL GBL. 






INDEX 


■ror, 

3-10, 

3-13, 5-10, 

6-15, 

6-25, 

6-26, 

6-28, 6-29 

, 6-32, 

6-33, 

6-38, 

6-40, 6-42 

. 6-44, 

6-47, 

6-56, 

7-2, 7-12 

to 7-14, 

7-16, 

7-17, 

7-20 



Absolute address, D-2 
Absolute binary output, 6-19 
Absolute expression, 3-17 
Absolute mode, 5-1, 5-7, 

B-2, G-2, G-4 
Absolute module, 6-42 
Absolute program section, 6-42 to 
6-45, B-4. See also .ASECT 
directive 

ADD instruction, E-12, G-3, H-2 
Addition operator, 3-2, 3-5, B-l 
Address boundaries, 6-39 
Addressing modes, 5-1 
Apostrophe, G-4 
ASCII 

character set, A-l 
conversion characters, 6-23 to 
6-26 


.ASCII directive, 6-1, 6-21, 6-26 
to 6-28, 6-36, B-3 
•ASCIZ directive, 6-1, 6-28, 

6-36, B-4 

.ASECT directive, 3-11, 3-13, 

3-14, 6-2, 6-44 to 6-47, B-4 
Assembler directives. See Permanent 
symbol table 
version number, 6-4 
Assembly 

error. See A error 
listing symbols, 4-1 
pass 1, 1-1, 1-2, 6-12, 6-15, 
6-16, 6-49, 8-10, 8-12, 

D-3 


pass 2, 1-2, 6-12, 6-21, 7-15, 
D-3 


Assignment operator. See Direct 
assignment operator 
Assignment statement. See Direct 
assignment statement 
Autodecrement deferred mode, 5-1, 
5-5, B-2, G-l 


Autodecrement indicator, 3-2 
Autodecrement mode, 5-1, 5-4, 
B-l, B-2, G-l 


Autoincrement deferred mode, 5-1, 
5-4, B-2, G-l 


Autoincrement indicator, 3-2 
Autoincrement mode, 5-1, 5-3, 
B-2, G-l 


Base level, E-14 


BCC instruction, 

E-13 


BCS instruction, 

E-14 


BEQ instruction, 

H-2 


BGE instruction, 

E-13 


BGT instruction, 

E-14 


BHI instruction, 

E-14 


BHIS instruction 

, E-13 


BIC instruction, 

E-13 


Binary operator, 

3-4, 3-5, 

3-16 

Blank line, 2-1 

BLE instruction, 

E-14 


•BLKB directive, 

3-14, 6-2, 

6-36 

to 6-38, B-4 

, D-3 


•BLKW directive. 

3-14, 6-2, 

6-36 

6-38, 6-48, 

B-4, D-3 


BLO instruction. 

E-13 


BLOS instruction 

, E-13 


BLT instruction. 

E-13, H-2 


BNE instruction, 

E-10, G-3, 

H-2 

BR instruction, 

E-l0, E-ll, 

G-3 

Branch instruction 


addressing, 5- 

9, D-2 


use of, E-13 

.BYTE directive, 

6-2, 6-23, 

6-36 


B-4, D-4 


C bit, E-9 

CALL instruction, H-2 
Calling convention, E-8 
Character set 

ASCII, A-l to A-3 
legal, 3-1 to 3-3 
Radix-50, A-5, A-6 
CLR instruction, G-3, G-3, H-2 
CMP instruction, E-13, H-2 
Coding standard, E-l 
Comment, E-l, E-5 

delimiter, 3-2, B-l, E-12 
field, 2-1, 2-4, 2-5, E-l 
Commercial instruction set, C-3 
Common exit, E-ll 
Complex relocatable expression, 
3-18 

Complex relocation, 4-1, G-4 
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INDEX 


Concatenation indicator, 3-3, 

B-l, B-3 

Conditional assembly, 6-51 to 

6-56, 7-8, 7-16, D-4 
immediate, 6-56 

Conditional assembly block, 7-3, 
B-4, B-5 

Conditional assembly directive, 
6-49 

Copyright statement, E-5 

.CROSS directive, 6-2, 6-22, 

B-4, C-5 

Cross-reference listing, 3-12, 

6-19, 8-8, 8-9, 8-14, 8-16 to 
8-18, 9-2, 9-3, 9-5 to 9-7 

.CSECT directive, 3-11, 3-13, 

6-2, 6-44 to 6-47, 9-6, B-4 

Current location counter, 2-2, 

3-2, 3-12 to 3-14, 3-17, 5-8, 
6-11, 6-36 to 6-38, 6-43 to 
6-44, B-5, B-7, D-2, D-3 


D error, 2-3 
Data 

sharing, 6-45 
storage, 6-2 

storage directives, 6-23 
Default radix, 3-14 
Default register definitions, 
3-10, 6-21 

Deferred addressing indicator, 
3-2, B-l 

Delimiting characters, 3-3, 6-17, 
6-29, B-3 to B-5, B-8 
Device register, E-2 
Direct assignment 

operator, 3-1, 3-2, 3-9, B-l 
statement, 3-6 to 3-9, 3-13, 
6-37 

Directives. See Permanent 
symbol table 
DIV instruction, H-2 
Division operator, 3-2, 3-5, B-l 
Double ASCII character indicator, 
3-2, B-l 

.DSABL directive, 6-2, 6-19 to 
6-21, 8-6, 8-8, 9-4, B-4, 

D-l 

Dummy argument, 7-2, 7-11, 7-17 


E error, 6-40 

EMT instruction, 5-9, D-4 

.ENABL directive, 6-2, 6-19 to 

6- 21, 8-6, 8-8, 9-4, B-4, 

D-l, D-2, D-4, F-2 

.END directive, 6-2, 6-40, B-4, 
D-3, H-2 

.ENDC directive, 6-2, 6-12, 6-53 
to 6-56, 6-59, 7-3, B-4 
.ENDM directive, 6-13, 6-21, 7-2, 

7- 3, 7-6 to 7-8, 7-10, 7-11, 
7-17 to 7-19, B-4, B-8, F-3 


.ENDR directive, 7-19, 7-20, B-5, 
B-8 

Entry point symbol, 6-52 
.ERROR directive, 7-16, B-5, D-4 
Error messages, D-l to D-5 
.EVEN directive, 6-2, 6-29, 6-38, 
B-5 

Expression, evaluation of, 3-16 
Expression indicator, immediate, 
3-2, B-l 

External expression, 3-17 
External symbol, 6-52. See also 
Global symbol 


Field terminator, 3-2, B-l 
FILES-11, 6-19 

Floating-point directives, B-5. 

See also .FLT2 directive 
Floating-point indicator, B-3 
Floating-point processor, 3-14, 
6-34, 6-35, C-4 

Floating-point rounding, 6-19, 
6-32 

Floating-point truncation, 6-19, 
6-35 

. FLT2 directive, 6-2, 6-35, B-5 
.FLT4 directive, 6-2, 6-35, B-5 
FLX, 6-19 

Forbidden instructions, E-13 
Format control, 2-5 
Formatted binary, 6-19 
FORTRAN, 6-47, E-15, G-2 
Forward reference, 3-8, 3-9, 
3-10, 3-13, D-4 
illegal, D-3 

Function control switches. See 
Switches, function control 
Function directive, 6-18 


Global expression evaluation, 

3-17 

Global label, 6-51 

Global reference, 6-21, 6-51, 

F-4, G-4 

Global symbol, 1-2, 3-7, B-5, 

D-2, D-3, E-4 

Global symbol definition, 2-2, 
3-1, 3-2, 3-8, 6-51. See 
also .GLOBL directive 
Global symbol directory, 1-2 
.GLOBL directive, 3-7, 6-2, 6-51, 
B-5, E-4 


Hardware register, E-2 


I error, 6-28, 6-30 
IAS, 6-48, 7-21, 8-14 to 8-17, 

8-19 to 8-22, G-l 
.IDENT directive, 6-2, 6-16, B-5, 
D-2, E-5, E-7, E-15, H-l 
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INDEX 


.IF directive, 6-2, 6-12, 6-53 to 

6-59, 7-3, 7-8, B-5, D-l, D-2 
.IFF directive, 6-2, 6-56 to 

6-58, B-5 

•IFT directive, 6-2, 6-56 to 
6-58, B-5 

•IFTF directive, 6-2, 6-56, 6-57, 
B-6 

• IIF directive, 6-2, 6-59, B-6, 
D-l, D-2 

Illegal characters, 3-3, D-2, D-3 
Illegal forward reference, D-3 
Immediate conditional assembly, 

6- 59 

Immediate expression indicator, 
3-2, B-l 

Immediate mode, 5-1, 5-6, B-2, 
G-2, G-4 

Implicit .WORD directive, 2-1, 
2-4, 6-25 

•INCLUDE directive, 6-2, 6-61, 
9-8, B-6, C-6 

Indefinite repeat block. See 
Repeat block, indefinite 
Index deferred mode, 5-1, 5-5, 
B-2, G-2, G-4 

Index mode, 5-1, 5-5, 5-7, B-2, 
G-2, G-4 

Initial argument indicator, 3-2, 
B-l 

Initial expression indicator, 3-2 
Initial register indicator, 3-2, 
B-l 

Instruction set 
commercial, C-3 
PDP-11, C-l 
Interrupts, E-12 
.IRP directive, 7-2, 7-17 to 

7- 19, B-6, D-2 

.IRPC directive, 7-2, 7-17 to 

7-19, B-6, D-2 
Item terminator, 3-2, B-l 


JMP instruction, 5-3, E-13 
JSR instruction, 5-3, E-9 


L error, 2-1 
Label 

field, 2-1 to 2-3, E-l 
multiple definition, 2-3 
terminator, 3-1, B-l 
.LIBRARY directive, 6-2, 6-60, 
9-9, B-6, C-6 

•LIMIT directive, 6-3, 6-39, B-6 
Line format, E-l 

Line printer listing format, 6-5, 
6-6, 6-12. See also Listing 
control 

Linker, 1-2, 2-2, 6-17, 6-43, 
6-47, 6-51, F-4, G-l, G-4 
Linking, 4-1, 6-40 


•LIST directive, 6-3, 6-9 to 
6-14, 6-21, 8-6, 8-11, 

8-13, 9-4, B-6, D-l 
Listing control, 6-4 to 6-14. 

See also .LIST directive, 
.NLIST directive 
Listing control switches. See 
Switches, listing control 
Listing level count, 6-9, 6-10, 

6- 12, B-6, B-7 

Local symbol, 3-11, 3-12, 7-8, 

7- 9, D-4, E-4, F-2 

Local symbol block, 3-11, 3-12, 
6-20, D-4, F-2 

Location counter. See Current 
location counter 

Location counter control, 6-34 to 
6-36 

Logical AND operator, 3-2, 3-5, 
6-55, B-l 

Logical inclusive OR operator, 
3-2, 3-5, 6-55 
Logical OR operator, B-l 


M error, 2-3, 3-1, 3-2, 3-8 
Macro 

argument, 7-7, 7-14, 7-15, B-3 
argument concatenation, 7-11 
attribute directive, 7-12 
definition, 6-33, 7-1 to 7-13, 
7-15, 7-17, 7-18, 7-20, B-4, 
B-6, B-7, E-6, F-2 
directive, 7-1, 7-2, 7-4. See 
also .MACRO directive 
expansion, 7-1, 7-3, 7-5 to 
7-7, 7-9, 7-11, 7-17, B-7, 

D-4, F-2 

expansion listing, 6-9, 6-12 
keyword argument, 7-4, 7-10 
keyword indicator, 3-1 
name, 7-1, 7-2, 7-4, D-4, E-4 
nesting, 7-2, 7-3, 7-6, 7-17 
numeric argument, 7-7 
redefinition, F-3 
symbol, 3-6 

Macro call, 7-1, 7-4 to 7-11, 

7- 12, 7-20, B-l, B-6. See 
also .MCALL directive 

Macro call argument, 7-4 
Macro call numeric argument, 3-3 
.MACRO directive, 6-13, 6-21, 7-1 
to 7-9, 7-10, 7-11, 9-6, B-6, 
D-l, F-3 

Macro library directive. See 
.MCALL directive 
Macro symbol table, 3-6, 3-7 
MACRO-11 character set. See 
Character set, legal 
.MCALL directive, 7-20, 8-6, 

8- 15, 9-5 to 9-6, B-6, 

D-4, F-l to F-3 

.MDELETE directive, 7-21, B-7, C-7 
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Memory 

allocation, 6-42, 6-47, F-l, 

F-2 

conservation, F-l 
.MEXIT directive, 7-3, 7-18 to 
7-20, B-7 

Modularity, 6-44, E-8, F-l 
Module checking routine, E-9 
Module preface, E-5 
Monitor console routine, 8-1, 8-2 
MOV instruction, 3-13, 3-14, 

6-37, 6-58, D-l, E-13, G-2 to 
G-4, H-2 

MOVB instruction, H-2 
Multiple definition. See M error 
Multiple expression, 2-4 
Multiple label, 2-2 
Multiple symbol, 2-4 
Multiplication operator, 3-2, 

3-5, B-l 


N error, 3-15 
Naming standard, E-2 
.NARG directive, 7-8, 7-12, 7-13, 
B-7, D-2 

.NCHR directive, 7-12, 7-13, B-7, 
D-2 

Nested conditional directive, 
6-55, 6-58, 7-3 
.NLIST directive, 6-3, 6-9 to 

6-14, 6-16, 6-21, 8-6, 8-11, 
8-13, 9-4, B-7, D-l 
.NOCROSS directive, 6-3, 6-22, 
B-7, C-6 

.NTYPE directive, 7-12, 7-14, 

B-7, D-2 

Number of arguments. See .NARG 
directive 

Numeric argument indicator, B-l 
Numeric control 
operator, 6-33 
temporary, 6-36, B-3 
Numeric directive, 6-34 


0 error, 6-40, 6-56, 6-57, 7-4, 
7-12, 7-15, 7-21 
Object module name, 1-2 
.ODD directive, 6-3, 6-37, 6-38, 
B-7 

Operand field, 2-1, 2-4, E-l 
Operand field separator, 3-2, B-l 
Operation field, E-l 
Operator field, 2-1, 2-3, 2-4 
Overlay, 6-42, 6-44 


P error, 6-20, 7-16 
.PACKED directive, 6-3, 6-31, 
6-37, B-7, C-7 

.PAGE directive, 6-3, 6-17, 7-4, 
B-7 


Page 

header, 6-4 
number, 6-17 
Patch, E-l5 

Permanent symbol table, C-l to 
C-3, 3-6, 3-7 

Position-independent code, G-l to 
G-4 

.PRINT directive, 7-17, B-7 
Processor priority, E-2 
Program counter, 5-1, E-2, G-4 
Program counter definition, 3-10 
Program development system, 8-14 
Program module, E-5 
Program section directive. See 
.PSECT directive 
Program section name, 6-41 
Program section table, 1-1 
Program version number. See 

Version identifier, program 
Programming standard, E-l 
.PSECT directive, 3-12, 3-14, 

6-2, 6-3, 6-20, 6-41 to 
6-48, 7-9, 9-6, B-7, D-l, 

D-2, H-2 


Q error, 6-29, 6-34, 6-38 


R error, 3-10 

.RAD50 directive, 6-3, 6-29, 

B-8, H-2 

Radix control, 3-15, 6-32, 6-34, 
B-8 

temporary, 6-31, 6-33, B-3 
.RADIX directive, 3-15, 6-3, 

6-32, B-8, D-l 

Radix-50, 3-5, 6-30, 6-41, B-3, 
B-5, B-8 

character set, A-4 
temporary operator, 6-31 
Read-only access, 6-41 
Read/write access, 6-41 
Register 

conventions, E-9 
definitions, default, 3-10, 

6-21 

expression, 5-2, B-l 
symbol, 3-10, D-4 
term indicator, 3-2, B-l 
Register deferred mode, 5-1, 5-2, 
B-2, G-l 

Register mode, 5-1, 5-2, B-2, G-l 
Relative deferred mode, 5-1, 5-8, 
B-2, G-2, G-4 

Relative mode, 5-1, 5-7, 5-8, 

B-2, G-2, G-4 

Relocatable expression, 3-17 
Relocatable module, 6-43 
Relocatable program section, 6-44 
to 6-47, B-4 
Relocation, 4-1, 6-43 
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Relocation bias, 2-2, 3-17, 3-18, 
4-1, 6-43 

.REM directive, 6-3, 6-18, B-8, 
C-7 

Repeat block 

directive. See .REPT directive 
indefinite, 7-3, 7-17 to 7-20, 
B-4, B-6 

.REPT directive, 7-2, 7-17, 7-20, 
B-8, D-3 

Reserved symbols, 2-3, 3-1, 3-7 
.RESTORE directive, 3-11, 3-14, 

6-3, 6-20, 6-49, B-8, C-7, 

D-3 

•RETURN directive, H-2 
RSTS, 9-1 to 9-9 
RSX run-time system, 9-1, 9-2 
RSX-11M, 6-17, 6-41, 6-48, 7-21, 

8- 1 to 8-13, 8-19 to 8-22, 
E-12, F-3, G-l 

RSX-11M-PLUS, 8-1 to 8-13, 8-19 
to 8-22, G-l 

RT-11, 6-17, 6-41, 6-43, 7-21, 

9- 1 to 9-9 

RT-11 run-time system, 9-1 


.SAVE directive, 6-3, 6-20, 6-49, 

6- 50, B-8, C-7, D-3 

•SBTTL directive, 6-3, 6-4, 6-15, 
B-8, H-2 

Separating characters, 3-3 
Sequence number, 6-19 
Single ASCII character indicator, 
3-3, B-l, B-3 
Source line format, 2-5 
Source line terminator, B-l 
Special characters, 3-1 to 3-3, 

7- 7 

Stack pointer, E-2 
definition, 3-10 
Statement format, 2-1 
SUB instruction, E-13 
Subconditional assembly, 6-56 to 
6-59 

Subtraction operator, 3-2, 3-5, 
B-l 

Success/failure indicator, E-9 
Switches 

file specification, 8-6 
function control, 8-6, 9-4 
listing control, 8-6, 8-7, 

9-4 

Symbol name syntax, E-3 
Symbol table, 1-1, 1-2, F-l 
Symbolic argument, 6-41 
SYSLIB, F-4 

System macro library, 1-1, 7-20, 

8- 4, 8-14, 9-3, 9-5. See 
also .MCALL directive 


T error, 3-15, 6-24 

Table of contents, 6-12, 6-16, 

B-8 

Task builder. See Linker 
Teleprinter listing format, 6-7, 
6-13. See also Listing 
control 

Temporary numeric control. See 
Numeric control, temporary 
Temporary radix control. See 
Radix control, temporary 
Temporary Radix-50 operator, 6-31 
Term, definition of, 3-15 
Terminal argument indicator, 3-2, 
B-l 

Terminal expression indicator, 

3-2 

Terminal register indicator, 3-2, 
B-l 

Terminating directive. See .END 
directive 
Thrashing, F-l 

.TITLE directive, 6-3, 6-4, 6-13, 
6-15, 6-21, B-8, D-2, E-5, 

E-7 , E-16, H-l 
TRAP instruction, 5-9, D-4 
TST instruction, E-10, E-ll, H-2 


U error, 3-8, 3-9, 3-15, 6-21, 
7-21, 8-7, 8-9, 8-15 
Unary operator, 3-4, 3-16, 7-5, 
7-7 

control, 6-32, 6-34 
universal, 3-3, 3-5, B-l 
Unconditional assembly, 6-56 
Undefined symbol, 3-8, 6-21, D-2, 
D-4. See also U error 
Universal unary operator. See 
Unary operator, universal 
Upper-case ASCII, 6-19 
User-defined symbol, 3-6 to 3-8 
User-defined symbol table, 2-2, 
3-6 to 3-8, 3-15 


Version identifier 
assembler, 6-4 
file, 8-20 
program, 6-17, B-5 
standard, E-14 to E16. See also 
•IDENT directive 


•WEAK directive, 6-3, 6-52, B-8, 
C-7 

.WORD directive, 3-13, 3-14, 6-3, 
6-24, 6-34, 6-36, B-8. See 
also Implicit .WORD directive 


Z error, 5-3 
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ADDITIONAL DOCUMENTATION 
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From 

Call 

Write 

Chicago 

312-640-5612 

8:15 a m. to 5:00 p.m. CT 

Digital Equipment Corporation 
Accessories & Supplies Center 

1050 East Remington Road 
Schaumburg, IL 60195 

San Francisco 

Alaska, Hawaii 

408-734—4915 

8:15 a.m. to 5:00 p.m. PT 

603-884-6660 

8:30 a.m. to 6:00 p.m. ET 

Digital Equipment Corporation 
Accessories & Supplies Center 

632 Caribbean Drive 

Sunnyvale, CA 94086 


or 408-734-4915 

8:15 a m to 5:00 p m. PT 


New Hampshire 

Rest of U.S.A., 
Puerto Rico* 

603-884-6660 

8:30 a m. to 6:00 p.m. ET 

1-800-258-1710 

8:30 a m. to 6:00 p.m. ET 

Digital Equipment Corporation 
Accessories & Supplies Center 

P.O. Box CS2008 

Nashua, NH 03061 

‘Prepaid orders from Puerto Rico must be placed with the local DIGITAL subsidiary (call 809-754-7575) 

Canada 

British Columbia 

Ottawa-Hull 

1-800-267-6146 

8:00 a m to 5:00 p.m. ET 

613-234-7726 

8:00 a m. to 5:00 p.m. ET 

Digital Equipment of Canada Ltd 

940 Belfast Road 

Ottawa, Ontario K1G 4C2 

Attn: A&SG Business Manager 

Elsewhere 

112-800-267-6146 

8:00 a.m. to 5:00 p.m. ET 


Elsewhere 


Digital Equipment Corporation 

A&SG Business Manager* 


*c/o DIGITAL’S local subsidiary or approved distributor 
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READER’S COMMENTS 

NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 
company’s discretion. If you require a written reply and are eligible to receive one under Software 
Performance Report (SPR) service, submit your comments on an SPR form. 


PDP-11 MACRO-11 
Language Reference 
Manual 
AA-V027A-TC 


hi Did you find this manu al understandable, usable, and well organized? Please make suggestions for improvement. 

~ = 


Did you find errors in this manual? If so, specify the error and the page number 
— - 



Please indicate the type of user/reader that you most nearly represent. 


— Assembly language programmer 

— Higher-level language programmer 

— Occasional programmer (experienced) 

— User with little programming experience 

— Student programmer 

— Other (please specify)_ 



Name----- Date___ 

Organization---Telephone _ 

Street______ 

Ci *y-----State-Zip Code_ 

or Country 
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